How to Use the Surfer SEO MCP in Windsurf

Q: How do I use Surfer SEO with Windsurf for content creation?

Start by using createcontenteditor. You pass it the core keyword and location, and Windsurf handles the rest. It generates a complete guideline so you don't have to manually structure anything.

Q: Can I check my content score using Surfer SEO with Windsurf?

Absolutely. After running an audit, call getcontentscore and pass the specific editor details. This lets you track your progress right inside the agent's workflow.

Q: Is the Surfer SEO functionality stable when using Windsurf?

Yes. The entire set of tools—including listseoaudits and getauditdetails—is designed for autonomous, multi-step execution within the MCP Server framework.

Automated SEO Content Planning for Windsurf Users.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Surfer SEO MCP to Windsurf

Create your Vinkius account to connect Surfer SEO to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Surfer SEO with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Generate Content Editor Queries with Windsurf

You kick off content creation using `create_content_editor`, giving it a target keyword and country code. This is an async operation, so you set the goal, and your agent handles the wait time. When it's done, you get a structured editor ready for writing.

Audit Live Pages using Surfer SEO MCP Server

To check if a published page hits its stride, run `create_seo_audit` with the full URL and target keyword. After the audit runs, use `get_content_score` to retrieve the current optimization score for that specific entry. It tells you exactly how close your content is to matching top competitors.

Identify Key Topics via Surfer SEO MCP Server

Need to know what's hot in the SERP? Call `get_prominent_terms` after an audit. This tool uses NLP to pull out the most important, naturally occurring terms from search results. It gives you quick insight into topic clusters and high-ranking language.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "surfer-seo-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 Surfer SEO. 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 Surfer SEO 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 Surfer SEO MCP in Windsurf

Start by using `create_content_editor`. You pass it the core keyword and location, and Windsurf handles the rest. It generates a complete guideline so you don't have to manually structure anything.

Absolutely. After running an audit, call `get_content_score` and pass the specific editor details. This lets you track your progress right inside the agent's workflow.

This MCP Server handles URLs, target keywords, and content guidelines. You're dealing primarily with structured text and quantitative scoring metrics.

Yes. The entire set of tools—including `list_seo_audits` and `get_audit_details`—is designed for autonomous, multi-step execution within the MCP Server framework.

The server manages URLs, content editor IDs, keywords, and audit results. These are all textual identifiers plus quantitative scores for optimization.

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