How to Use the Umbraco MCP in Windsurf

Q: Can Umbraco drafts be managed using this MCP Server with Windsurf?

Yes. You can use the getmanagementdocument tool. This reads specific documents directly from the Umbraco Management API, giving you access to draft content that isn't live on the site.

Q: What happens if I run a complex query using the MCP Server with Windsurf?

The querydeliverycontent tool runs the filter against Umbraco and returns results. Because of how Windsurf works, it takes that resulting data set and immediately feeds it into the next step of your plan.

Q: Is listing content via the MCP Server with Windsurf limited in scope?

No. The listdeliverycontent tool supports pagination using both take and skip. That means you can list large amounts of Umbraco content without hitting any artificial limits.

Run complex CMS operations with Windsurf. Automate your Umbraco workflows and manage content without manual prompts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Umbraco MCP to Windsurf

Create your Vinkius account to connect Umbraco 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 Umbraco with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Managing Content Status via MCP Server

Need to update a document? The `update_cms_document` tool lets you modify existing fields in Umbraco. You provide the document ID and the new JSON data, and it writes changes directly. This also handles content creation with `create_cms_document`. Just give it the schema details, and your agent builds a brand-new document right inside Umbraco CMS.

Querying Content Structure

Figure out what schemas are available using `list_document_types`. This tool lists every document type (schema) defined in the Umbraco backoffice. Want to find specific pieces of content? Use `query_delivery_content` by specifying criteria, like a particular content type. It filters results from Umbraco using its native Delivery API query syntax.

Media and Asset Handling

Access all your files with the dedicated media tools. `list_media_assets` gives you a rundown of every image or file sitting in the Umbraco Media library. If you need to pull specific text, `get_delivery_content_by_path` works off a URL path (like `/home/about`). It pulls that exact content item right out of Umbraco for your agent to use.

Setup guide

Set up Umbraco 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 Umbraco 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 Umbraco payment history." If connected, Cascade will call the Umbraco tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "umbraco-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 Umbraco. 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 Umbraco 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 Umbraco MCP in Windsurf

Windsurf figures it out. You tell it a goal—like 'Update the homepage content and delete the old draft.' It automatically chains multiple tools, like `get_delivery_content_by_id` then `update_cms_document`, without you having to prompt for each step.

Yes. You can use the `get_management_document` tool. This reads specific documents directly from the Umbraco Management API, giving you access to draft content that isn't live on the site.

The `query_delivery_content` tool runs the filter against Umbraco and returns results. Because of how Windsurf works, it takes that resulting data set and immediately feeds it into the next step of your plan.

No. The `list_delivery_content` tool supports pagination using both `take` and `skip`. That means you can list large amounts of Umbraco content without hitting any artificial limits.

This server touches document schemas, media assets, and live/draft content. You need to be careful about who sees the raw JSON output from tools like `get_management_document`.

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