How to Use the Cosmic MCP in Windsurf

Q: Can I preview draft structures inside Windsurf before publishing to Cosmic?

Yes. Cascade uses getschemadetails to pull your validation rules directly into the editor. You can review the exact JSON payload shape before Cascade commits it to your live environment.

Q: What happens when Cascade deletes a Cosmic asset in Windsurf?

Cascade invokes wipecmsobject to immediately drop the document row. It then triggers wipemediaasset to clear the linked image file from your disk storage.

Let Cascade build, modify, and purge Cosmic CMS content directly from your Windsurf editor without writing API boilerplate.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cosmic MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Edit live CMS content with Windsurf Cascade

`patch_cms_object` lets Cascade modify live drafts inside your bucket by targeting specific document IDs. When you tell Cascade to update a pricing table or fix a typo, it drafts the changes and executes the patch without forcing you to log into the web dashboard. You can also use `create_cms_object` to spin up brand new drafts on the fly. Cascade handles the JSON structure and pushes the new node directly into your headless environment, making content staging a background task.

Inspect bucket schemas and media assets

`get_schema_details` extracts the exact property fields from your active content models so Cascade understands your data shape. Cascade inspects these rules before writing updates, ensuring every field matches your validation requirements. To handle images, Cascade uses `get_media_asset` and `list_uploaded_media` to check your asset library. It tracks down specific image IDs and verifies file dimensions so you never link a broken image to your homepage.

Clean up deprecated content nodes

`wipe_cms_object` permanently deletes specific document rows from your active Cosmic bucket. When a marketing campaign ends, Cascade identifies the stale nodes and drops them from your live schema to keep your API payloads clean. This cleanup process also triggers `wipe_media_asset` to purge unused files from the disk. Cascade checks for dangling media links and removes the orphaned files to prevent your cloud storage costs from ballooning.

Setup guide

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

mcp_config.json

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

Cascade reads your local workspace context and maps it directly to your headless bucket. It automatically calls `patch_cms_object` to push edits without requiring manual API scripting.

Yes. Cascade uses `get_schema_details` to pull your validation rules directly into the editor. You can review the exact JSON payload shape before Cascade commits it to your live environment.

Cascade invokes `wipe_cms_object` to immediately drop the document row. It then triggers `wipe_media_asset` to clear the linked image file from your disk storage.

The MCP Server reads your environment variables to switch between production and staging buckets. Cascade uses `list_bucket_objects` to route updates to the correct environment based on your current branch.

No. Your Cosmic CMS objects and media assets stay within your local Windsurf sandbox and your direct Cosmic API connection. Vinkius runs the MCP Server in an isolated V8 container, ensuring your draft payloads never leak to external networks.

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