Set up OpenSEO MCP

OpenSEO MCP lets compatible AI clients call OpenSEO tools for keyword research, SERP inspection, local business research, competitive search intelligence, domain research, backlink overview, saved keywords, rank tracking, shared project context, and Google Search Console performance and URL inspection.

In ChatGPT or Claude, add OpenSEO from their directories:

For other clients, the hosted MCP server URL is:

https://app.openseo.so/mcp

The first connection sends you through OpenSEO login. After authorization, your MCP client can call OpenSEO tools with the project context and account scopes you approved. For headless environments and CI, connect with an API key instead.

For the most current setup UI and a copyable endpoint, open Agent setup in OpenSEO.

For setup prompts, plugin commands, and skill updates, see Agent setup.

No account yet? Try the free SEO tools.

Choose your clientCopy Anchor Link

CursorCopy Anchor Link

1. Open Cursor Settings -> Tools & Integrations -> MCP Tools.
2. Click New MCP Server. Cursor opens mcp.json.
3. Add:

{
  "mcpServers": {
    "openseo": {
      "url": "https://app.openseo.so/mcp"
    }
  }
}

4. Approve the OpenSEO login when prompted.

Connect with an API keyCopy Anchor Link

Use an API key in headless environments, CI, or clients where OAuth is inconvenient. API keys are personal: anything an agent does with your key acts as you in the workspace that was active when you created it.

In the OpenSEO app, open Settings -> API keys, create a key, and copy it when it appears. It won't be shown again.

For Claude Code, run:

claude mcp add --transport http --scope user openseo https://app.openseo.so/mcp --header "Authorization: Bearer oseo_YOUR_KEY"

For Cursor, add headers to the server entry in mcp.json:

{
  "mcpServers": {
    "openseo": {
      "url": "https://app.openseo.so/mcp",
      "headers": {
        "Authorization": "Bearer oseo_YOUR_KEY"
      }
    }
  }
}

For Codex CLI, put the key in an environment variable and reference it:

export OPENSEO_API_KEY=oseo_YOUR_KEY
codex mcp add openseo --url https://app.openseo.so/mcp --bearer-token-env-var OPENSEO_API_KEY

Any other client that supports custom HTTP headers can send Authorization: Bearer oseo_YOUR_KEY or x-api-key: oseo_YOUR_KEY.

Workspaces and revoking accessCopy Anchor Link

An OAuth connection or API key is tied to the workspace that was active when you authorized or created it. To use OpenSEO in another workspace, connect again and pick that workspace on the authorization page, or switch to it in the app before creating a key. To disconnect an agent, open Settings and choose Disconnect under Connected agents. To revoke a key, choose Revoke key under API keys. A disconnected agent has to sign in again before it can call OpenSEO.

Available toolsCopy Anchor Link

See OpenSEO MCP tools for everything your agent can do through OpenSEO MCP, and which tools use credits.

What to do after setupCopy Anchor Link

See the AI Visibility guide for supported engines, research coverage, and costs.

Once OpenSEO MCP is connected, set up OpenSEO Agent Skills. MCP gives your agent access to OpenSEO data. Skills are separate SKILL.md files that tell your agent how to use that data for specific SEO jobs.

Start with one focused workflow instead of asking your agent to "do SEO" broadly.

• Use SEO project setup to save your goals, positioning, competitors, and key pages to your project context, so every other skill reuses them.
• Use SEO coach if you are new to SEO or are not sure which workflow to run first.
• Use AI Prompt Research to find questions and cited sources before choosing what to track.
• Use AI Visibility Audit to investigate why competitors appear and which changes to try.
• Use keyword research to discover keyword opportunities.
• Use competitive landscape to map a market before choosing competitors or pages.
• Use competitor analysis to study one competitor.
• Use keyword clustering to turn keywords into page groups.
• Use link prospecting to find outreach prospects for a linkable asset.

TroubleshootingCopy Anchor Link

If your client cannot connect, check that the server URL is exactly https://app.openseo.so/mcp.

If authorization fails, disconnect the OpenSEO server in your client, add it again, and repeat the login flow.

If your agent cannot find a project, ask it to list OpenSEO projects first and use the returned project ID in later tool calls.

For client-specific errors, see the troubleshooting sections for ChatGPT, Claude and Codex.