Integration

ContextBolt SEO in Cursor (2026 Setup Guide)

Beginner 2 minutes setup By David Hamilton

Cursor is the AI-first code editor a lot of builders now live in. It speaks the Model Context Protocol, so you can plug in ContextBolt SEO and pull live keyword, SERP, domain, and competitor data straight into the editor where you are already shipping.

Like Claude Code, Cursor 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, version-controlled and searchable, instead of scattered across browser tabs.

SEO without leaving the editor

When you are building the page, that is the moment to decide what it should rank for. With ContextBolt SEO in Cursor you ask “what should this page target, and who already owns those terms?” and the answer comes back in the chat pane. No dashboard, no export, no context switch.

Because these are MCP tools, Cursor chains them. “Find five low-difficulty keywords for my pricing page, check who ranks for each, and note the gaps” is one prompt that calls several tools and writes the whole session to disk.

Keeping the config clean

Add the server to your global ~/.cursor/mcp.json so it follows you across projects, or to a project-level .cursor/mcp.json if you only want it in one workspace:

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

Your URL holds a personal token, so prefer the global config over a committed project file, or pull the URL from an environment variable. Once it shows a green dot in Settings, MCP, you are set. The full tour of tools and workflows is in the ContextBolt SEO guide.

How to connect ContextBolt SEO to Cursor

  1. 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.

  2. Add it to your mcp.json

    Open Cursor Settings, then MCP, then Add new MCP server, or edit ~/.cursor/mcp.json directly. Under mcpServers add: "contextbolt-seo": { "url": "https://seo.contextbolt.app/mcp/YOUR_TOKEN" }. Save the file.

  3. Enable and check it

    Back in Settings, MCP, make sure contextbolt-seo shows a green dot and its tools are toggled on. Then open the chat pane and ask 'what SEO tools do you have?'. If it lists keyword, SERP, and domain tools, you are live.

  4. Connect your Search Console (optional, free)

    Ask 'connect my Google Search Console', approve read-only access on Google's consent screen, and Cursor can 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 + Cursor

Once connected, try asking Cursor:

I'm building a SaaS landing page. What keywords should it target?

Cursor calls keyword_research and returns related terms with volume, difficulty, and intent, so you can plan copy and content while you build.

How hard is 'open source crm' 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 to model your page on, without leaving the editor.

What does linear.app rank for, and who else competes for those terms?

Runs ranked_keywords then competitor_keywords for a content map plus the full set of rivals chasing the same keywords.

Who links to my biggest competitor but not to me?

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 Cursor

Run keyword research in plain English while you build

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

ContextBolt SEO + Cursor: FAQs

Where exactly does the config go? +
Cursor reads MCP servers from ~/.cursor/mcp.json for global use, or .cursor/mcp.json inside a project for that workspace only. Add contextbolt-seo under the mcpServers object with your URL, then enable it in Settings, MCP.
The server shows up but the tools are greyed out. Why? +
Cursor lists a server before you enable its tools. Open Settings, MCP, find contextbolt-seo, and toggle it on. If it still will not connect, re-check that the URL is pasted in full with no trailing space.
What is the ./seo-findings/ folder? +
Every lookup writes a markdown file into a ./seo-findings/ folder in your workspace, one file per keyword or domain plus an INDEX. You can search it, commit it to git, or open it in Obsidian. The files are free and do not count against your 1,000 monthly lookups.
How many lookups does a question cost? +
The six research tools cost one lookup each. The three 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 out of a shared repo? +
Yes. Put the server in your global ~/.cursor/mcp.json rather than a committed project file, or use an environment variable for the URL. Your MCP URL contains a personal token, so treat it like a password.