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.
Windsurf has file access, so every lookup you run is mirrored to a ./seo-findings/ folder in your workspace as markdown. Your SEO research lives next to your code, searchable and version-controlled.
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. No dashboard, no export, 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 writes the session to disk.
The config entry
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.
How to connect ContextBolt SEO to Windsurf
-
Subscribe and get your MCP URL
Subscribe to ContextBolt SEO ($35/month for 1,000 lookups). Your private MCP URL arrives by email and looks like https://seo.contextbolt.app/mcp/YOUR_TOKEN. Keep it private, like a password.
-
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.
-
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.
-
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 lookups.
Example prompts for ContextBolt SEO + Windsurf
Once connected, try asking Windsurf:
Cascade calls keyword_research and returns related terms with volume, difficulty, and intent, so you can plan the page while you build it.
Chains keyword_difficulty and serp_overview so you get a difficulty score and the live page-one results without leaving Windsurf.
Runs ranked_keywords then competitor_keywords for a content map plus the rivals chasing the same terms.
Calls backlink_gap and returns a spam-scored prospect list, a ready-made outreach shortlist. Backlink calls cost three lookups each.
What you can do with ContextBolt SEO 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
Save every lookup to ./seo-findings/ in your workspace as markdown