MCP Server/Connect Cursor

MCP Guide · Free · Read-only

Connect Cursor to SEOMentor

Cursor supports remote MCP servers two ways — a settings panel, or a config file you edit directly. Either gets you the same thing: Cursor can read your real SEOMentor scan and traffic data while you're working.

Before you start

A SEOMentor account with at least one completed scan
A recent version of Cursor (MCP support requires it)

Connect in 3 steps

Open Cursor's MCP settings

Go to Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly, see the config below).

Add SEOMentor as a remote server

If using the config file instead of the UI, this is the exact JSON to add:

{
  "mcpServers": {
    "seomentor": {
      "url": "https://www.seomentor.io/mcp"
    }
  }
}

Approve the OAuth prompt

Cursor opens your browser to SEOMentor's sign-in and consent screen — approve it, then Cursor picks up the connection automatically.

Try it once connected

Ask these, word for word or close to it — Cursor calls SEOMentor's MCP tools behind the scenes and answers using your real account data.

You ask:

“What's my current SEO score for [yoursite.com] and what's the biggest issue dragging it down?”

Example of what comes back:

Cursor calls get_scan_results for that site, reads through the scored categories, and names whichever issue has the largest point impact — often a Core Web Vitals or missing-metadata problem.

You ask:

“Show me the search queries that lost the most clicks in the last month.”

Example of what comes back:

It calls get_gsc_performance and sorts the returned queries by click change, surfacing the ones trending down first — a fast way to spot a ranking drop before it shows up anywhere else.

You ask:

“Give me a one-paragraph account summary — total scans, average score.”

Example of what comes back:

It calls get_account_overview, which returns exactly those account-wide totals, and Cursor writes it up in plain sentences.

What Cursor can and can't do

Every tool on SEOMentor's MCP server is read-only. Cursor can pull your scan results, Search Console and Analytics data, and score history — it can't start a new scan, change a setting, or touch billing. The connection uses OAuth, so you approve it once on a consent screen and can revoke it anytime from SEOMentor settings or from Cursor itself.

Troubleshooting

The server shows as added but never authenticates

Check that Cursor's browser popup for OAuth wasn't blocked — some OS/browser combos silently block the redirect. Try adding the server again and watch for the sign-in window.

Cursor can't find the config file

The mcp.json file may not exist yet on a fresh install — create it at ~/.cursor/mcp.json (Mac/Linux) or the equivalent path Cursor's docs list for Windows, then restart Cursor.

It's returning data for the wrong site

If you manage multiple sites in SEOMentor, be specific about the hostname in your prompt — ask it to call list_sites first if you're not sure of the exact one to reference.

Disconnect anytime

—Settings → MCP → remove the SEOMentor entry, or delete it from mcp.json.
—In SEOMentor: Settings → Connected Apps → revoke Cursor's access.

FAQ

Does every teammate need to add this separately?

Yes — the OAuth approval is per-person, tied to each person's own SEOMentor login, even if the mcp.json config file is shared in a repo.

Will this show up as an MCP tool call in my Cursor chat?

Yes, Cursor typically shows when it's calling a tool (which one, with what arguments) before returning the answer, so you can see exactly what data it pulled.

Is putting the URL in mcp.json safe to commit to a repo?

The server URL itself isn't sensitive — it's a public endpoint. The actual access token from your OAuth approval is stored locally by Cursor, not in that file.

No SEOMentor account yet?

Get started free