How to Use the Framer MCP in Windsurf

Q: How do I connect the Framer MCP Server to Windsurf Cascade?

Add the server configuration to your mcpconfig.json file under the mcpServers block. Cascade detects the tools instantly on startup, allowing you to ask it to update your site.

Q: Can Windsurf Cascade run publishsite on Framer without my manual approval?

Yes, Cascade chains the execution of publishsite autonomously once you set the goal. It reads your project state, runs the necessary CMS updates, and pushes the changes live.

Q: How does Windsurf handle schema mismatches during Framer CMS updates?

Cascade uses listcollections to inspect the live schema first. If a mismatch occurs, it edits the payload structure in memory before retrying the item creation.

Q: What is the fastest way to verify my Framer projects inside Windsurf?

Ask Cascade to list your current work. It runs listprojects and displays your active files directly in the chat panel.

Let Cascade edit, manage, and publish your Framer sites directly from your Windsurf workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Framer MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomously sync and publish Framer sites with Windsurf

The `publish_site` tool lets Cascade push live design and content updates to your production domain without you clicking around the browser. Cascade reads your local markdown files, maps them to your schema, and triggers a build in one shot. You specify the target project, and this MCP Server handles the rest. Skip the manual export-import hassle of the Framer visual editor when using Windsurf.

Chain CMS updates in Windsurf without manual intervention

The `create_collection_item` tool gives Cascade direct write access to your Framer CMS collections. When you feed it a directory of draft files, the agent runs a sequence to check existing entries and inject new ones. Cascade uses `list_collections` first to locate the right database schema. It then populates the fields programmatically, keeping your live blog or portfolio perfectly mirrored.

Audit your layout structure from the Windsurf editor

The `list_pages` tool exposes your entire site map directly to Cascade for real-time validation. Cascade scans this page list to map out internal links or find layout inconsistencies before you push changes. By pairing this MCP Server with `get_site_info`, the agent validates your staging setup against production. You get a clean structural overview without opening a single browser tab.

Setup guide

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

mcp_config.json

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

Add the server configuration to your `mcp_config.json` file under the `mcpServers` block. Cascade detects the tools instantly on startup, allowing you to ask it to update your site.

Yes, Cascade chains the execution of `publish_site` autonomously once you set the goal. It reads your project state, runs the necessary CMS updates, and pushes the changes live.

Cascade uses `list_collections` to inspect the live schema first. If a mismatch occurs, it edits the payload structure in memory before retrying the item creation.

Ask Cascade to list your current work. It runs `list_projects` and displays your active files directly in the chat panel.

Vinkius manages your API keys securely inside its isolated sandbox. Your raw Framer CMS content and design structure tokens never touch Windsurf's local configuration files.

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