How to Use the DatoCMS MCP in Windsurf

Q: Does this tool work with custom DatoCMS models?

Absolutely. Use listglobalmodels to fetch your unique schema definitions. The agent then adapts its tool calls to fit your specific content structure.

Manage your DatoCMS content directly within Windsurf by letting Cascade chain record updates and media tasks automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect DatoCMS MCP to Windsurf

Create your Vinkius account to connect DatoCMS to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup DatoCMS with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Full content control in Windsurf

Use `create_cms_record` or `patch_cms_record` to push live data updates without leaving your editor. Cascade reads your schema and fires off the right JSON payloads to keep your site current. Updating your CMS state becomes a background task. You define the goal for your content model, and the agent handles the item parameters internally.

GraphQL querying for Windsurf

Connect your project to `execute_graphql_cda` to pull live data structures directly into your workspace. It maps your content tree so you can write components against real production objects. Forget manual API testing. This MCP server lets your agent navigate the GraphQL graph, ensuring your UI logic matches your actual content structure.

Media management for Windsurf

Run `list_media_uploads` to scan your library and identify images attached to specific models. It gives you a clear view of your storage state without opening a browser tab. Need to clean up? Use `wipe_media_upload` to remove assets instantly. It handles the validation check so you don't break your site's image references.

Setup guide

Set up DatoCMS MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the DatoCMS MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my DatoCMS payment history." If connected, Cascade will call the DatoCMS tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "datocms-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by DatoCMS. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect DatoCMS now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about DatoCMS MCP in Windsurf

The server connects via the MCP protocol to expose your CMS data as native tools. Windsurf calls these tools to read or write records in real-time.

Yes, you can instruct Cascade to loop through records using `list_cma_records` and update them. It processes each mutation sequentially based on your logic.

Vinkius handles your connection securely. Your sensitive keys stay encrypted and are only used by the server to execute your specific CMS operations.

Absolutely. Use `list_global_models` to fetch your unique schema definitions. The agent then adapts its tool calls to fit your specific content structure.

Your content stays between your agent and the CMS API. We use ephemeral, zero-trust environments that discard your session data the moment the task finishes.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript