ContextBolt SEO in Windsurf (2026 Setup Guide)

A couple of minutes, and Windsurf Cascade answers with live search data.

7-day free trial · then $35/mo · 1,000 credits

SEO MCP server for Claude, Cursor & Codex Windsurf · ContextBolt connected live data

What should I write next?

Used keyword_research

email marketing toolsKD 49 · 4,400/mo

email automationKD 31 · 2,900/mo

welcome email examplesKD 22 · 1,600/mo

Trusted by 300+ users across the globe

It connects in 3 minutes.

Connect your ContextBolt account For OAuth, add https://seo.contextbolt.app/mcp and complete sign-in with your SEO account email and email code, then allow access. If your client cannot complete OAuth, follow the personal-URL compatibility steps on this page. Get that private URL from your ContextBolt SEO welcome email. Use one connection method.

Personal-URL setup: Open the Cascade MCP settings In Windsurf open Settings, then Cascade, then the MCP Servers section, and choose Add server, or edit the config file at ~/.codeium/windsurf/mcp_config.json directly.

Personal-URL setup: Add the server and refresh Under mcpServers add: "contextbolt-seo": { "serverUrl": "https://seo.contextbolt.app/mcp/YOUR_TOKEN" }. Save, then hit Refresh in the MCP Servers panel. Windsurf uses serverUrl for remote HTTP servers.

Personal-URL setup: Check it and connect Search Console (optional, free) In Cascade, ask 'what SEO tools do you have?' to confirm the tools loaded. Then ask 'connect my Google Search Console' and approve read-only access to read your real clicks, positions, and quick wins. The Search Console tools are free and never spend your monthly credits.

The guide covers every client and the compatibility options. The full setup guide

Then ask it something real.

“What keywords should my new product page target?” Cascade calls keyword_research and returns related terms with volume, difficulty, and intent, so you can plan the page while you build it.

“How hard is 'ai code review' to rank for, and who's in the top 10?” Chains keyword_difficulty and serp_overview so you get a difficulty score and the live page-one results without leaving Windsurf.

“What does supabase.com rank for, and who else competes?” Runs ranked_keywords then competitor_keywords for a content map plus the rivals chasing the same terms.

“Who links to my main competitor but not to me?” Calls backlink_gap and returns a spam-scored prospect list, a ready-made outreach shortlist. Backlink calls cost three credits each.

What it can do in Windsurf.

Run keyword research in plain English inside Cascade

Score how hard a keyword is to rank for before you write

See who ranks in Google's top 10 for any query

Size up any domain's traffic, keywords, and authority

Find the keywords a competitor already ranks for

Spot backlink gaps: who links to rivals but not you

Connect your own Google Search Console, read-only and free

Get a private SEO Dashboard that fills itself with your research, free

The longer story.

Windsurf is the agentic code editor from Codeium, and its Cascade agent speaks the Model Context Protocol. That means you can plug in ContextBolt SEO and pull live keyword, SERP, domain, and competitor data into the editor where you are already building.

Every lookup you run lands on your SEO Dashboard, a private page you sign in to from any machine. Your research stops vanishing into the chat and becomes a record you can scroll, filter and export.

SEO inside Cascade

The best time to decide what a page should rank for is while you are building it. With ContextBolt SEO in Cascade you ask “what should this target, and who already owns it?” and the answer lands in the chat. Every answer is saved to your SEO Dashboard, with no export and no context switch.

Because these are MCP tools, Cascade chains them. “Find five low-difficulty keywords for my features page, check who ranks for each, and note the gaps” is one prompt that calls several tools and files the whole session on your dashboard.

The config entry

Use https://seo.contextbolt.app/mcp and complete the browser sign-in if your client supports remote MCP with OAuth. Enter your SEO account email and email code, then allow the connection. For a client that cannot complete that flow, use the personal-URL compatibility configuration shown here. Copy the full private URL from your ContextBolt SEO welcome email and replace the example URL with it.

Add ContextBolt SEO under mcpServers in ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "contextbolt-seo": {
      "serverUrl": "https://seo.contextbolt.app/mcp/YOUR_TOKEN"
    }
  }
}

Note the key is serverUrl, which is what Windsurf expects for a remote HTTP server. Save the file, hit Refresh in the MCP Servers panel, and ask “what SEO tools do you have?” to confirm. Your URL holds a personal token, so keep the config off public repos. The full tour of tools and workflows is in the ContextBolt SEO guide.

Common questions.

Where is the Windsurf MCP config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. You can edit it directly or use the Add server button under Settings, Cascade, MCP Servers. After any change, hit Refresh in that panel so Cascade reloads the tools.

Should I use url or serverUrl?

For a remote HTTP MCP server like ContextBolt SEO, Windsurf expects serverUrl in the mcp_config.json entry. If the tools do not appear, check you used serverUrl, pasted the full URL, and pressed Refresh.

Where does my research get saved?

To your ContextBolt account, and it shows up on your SEO Dashboard, a private page that fills itself as you work. It is one URL, so the research follows you between machines and between agents instead of living in one project folder. Saving is free and never counts against your 1,000 monthly credits.

How many credits does a question cost?

Research tools cost one credit each. Backlink tools cost three each. The plan includes 1,000 a month, top-ups never expire, and checking your balance is free.

Can I keep my token private?

Yes. Your MCP URL contains a personal token, so treat it like a password. Keep mcp_config.json off public repos, and if you share a machine, remove the server when you are done.

ContextBolt SEO in Windsurf (2026 Setup Guide)

It connects in 3 minutes.

Then ask it something real.

What it can do in Windsurf.

The longer story.

SEO inside Cascade

The config entry

Common questions.

See it in your own chat.