Use SEOmatic in Cursor

Connect Cursor#

1. 1Add the mcp.json entry. Add a seomatic server with only the URL https://app.seomatic.ai/api/mcp to ~/.cursor/mcp.json or .cursor/mcp.json, as in the snippet below, or open Customize in the sidebar and add it under MCP.
2. 2Approve the browser sign-in. Cursor starts the OAuth flow in your browser. Sign in or create a free SEOmatic account, approve access and pick your site. If the prompt does not open, go to Customize > MCP, find seomatic (a yellow dot means it needs sign-in) and click Authenticate. In the Cursor CLI, run agent mcp login seomatic.
3. 3Connect Search Console. If your workspace has no Search Console yet, SEOmatic hands you a one-click connect link. There is no Google Cloud project to set up.
4. 4Ask the agent. Try “Audit our live site with SEOmatic and list the issues our code causes.”

// ~/.cursor/mcp.json (or .cursor/mcp.json in one repo),
// or Customize > MCP in the sidebar
{
  "mcpServers": {
    "seomatic": { "url": "https://app.seomatic.ai/api/mcp" }
  }
}
# one click: cursor://anysphere.cursor-deeplink/mcp/install?name=seomatic&config=eyJ1cmwiOiJodHRwczovL2FwcC5zZW9tYXRpYy5haS9hcGkvbWNwIn0=
# Cursor CLI: agent mcp login seomatic

mcp.json, One-Click Link or Skills Only?

Start with mcp.json. It works in every Cursor today and takes one entry. Want the 20 SEO skills too (an SEO audit, striking distance keywords, traffic drops, AI visibility, client reports and more)? Add them with npx skills add Minh42/seomatic-mcp --full-depth -a cursor; Cursor loads skills from .agents/skills and ~/.cursor/skills on its own. Cloud Agents do not read your mcp.json: a team admin adds SEOmatic under Dashboard > Plugins & MCPs instead.

Try Asking#

• “Audit our live site with SEOmatic and fix the issues that come from our code.”
• “Which of our pages get impressions but few clicks? Update their titles in the codebase.”
• “Find every page with a canonical pointing somewhere else and explain why.”
• “What queries do we get impressions for without a matching page?”
• “Compare the SEO of our preview deploy with production.”
• “Run the striking-distance skill and tell me which three pages to work on this sprint.”

What It Costs#

Connecting is free. Reading your own data never uses credits: Search Console performance and insights, index status, rankings, site audits, AI citations, traffic and your tasks. Only live market lookups (keyword metrics, search results, backlinks), AI visibility scans and the fixes you approve use AI credits; every tool is labelled free or billed. On the Free plan, market lookups count against 5 free questions a month. The workspace Owner sees every credit spent, by feature, in Settings > Usage. Cursor itself is billed by its maker, not by SEOmatic: nothing on our side counts tokens.

Nothing Changes on Your Site Without Your Approval#

Code changes in Cursor go through your normal review. Changes to a live site through a CMS connected to SEOmatic are staged, never pushed. A staged change is a proposal: it says what will change and why, and nothing touches your site until you approve it. The assistant records your decision, and it is told never to approve anything on its own judgment. Approved fixes start within seconds, the page's previous state is stored, and any applied change can be rolled back. Changes that could take a page out of Google, like a noindex, need an extra explicit confirmation.

Cursor says SEOmatic is connected but answers without my data.

Start a new chat and check that SEOmatic is enabled for that conversation in the tools menu. This is the step most people miss.

The SEOmatic page says "This connection request expired".

Start the connection again from Cursor, or paste the setup prompt again.

The Authorize page shows the wrong email or no workspace.

Click Switch account on that page and sign in with the SEOmatic account that owns the site.

Why does Cursor say it cannot change my site?

Fixes need a live paid plan or trial. On the Free plan, or when billing is paused or failed, your assistant can read and answer only.

How do I disconnect?

Open Settings > AI Agents, scroll to API Keys and delete the row named OAuth: Cursor. See disconnect an assistant.