Skip to main content

Serpstat MCP

Run Serpstat keyword research and site analysis via natural language in any MCP-compatible AI assistant. No manual data export or copy-pasting required.

Written by Mike

Run SEO Workflows in Plain Language With Serpstat MCP

Serpstat MCP connects AI assistants — Claude, ChatGPT, and other MCP-compatible clients — directly to Serpstat data. Instead of opening dashboards and exporting spreadsheets, you describe a task in plain language. The AI runs it with Serpstat data: domain analysis, keyword research, competitor gaps, backlinks, rank tracking, and site audits.

What you can achieve:

  • Run multi-step SEO workflows without switching tools: Chain domain analysis → keyword gap → content brief in one conversation. The AI keeps context between steps — no repeating inputs, no resets.

  • Automate routine research tasks: Keyword research, competitor analysis, backlink prospecting, rank tracking checks — delegate these to the AI and get structured results in seconds.

  • Work with Serpstat API methods through natural language: The MCP server exposes all API methods, from keyword research to site audits.

Getting Started

Serpstat MCP comes in two versions. The HTTP version connects in a few clicks with no installation. The STDIO version runs on your computer and lets you choose which tool groups to enable.

HTTP version (Claude, ChatGPT):

  1. In your AI client, open Settings and find Connectors. In ChatGPT, this section can be called Apps.

  2. Add a custom connector. Name: Serpstat SEO Tools. URL: https://serpstat.com/api/mcp/.

  3. Click Connect. Serpstat opens the authorization page.

  4. Log in to your Serpstat account if needed and click Allow access.

  5. Start a new chat and ask: "How many Serpstat API credits do I have left?" This check is free.

STDIO version (Claude Desktop, Claude Code, Cursor, Gemini CLI):

  1. Install Node.js 18.0.0 or higher from nodejs.org.

  2. In your Serpstat account, go to Profile and copy your API token.

  3. Open your AI client's MCP configuration file. For Claude Desktop:
    macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    Windows: %APPDATA%/Claude/claude_desktop_config.json

  4. Add the Serpstat server entry: { "mcpServers": { "serpstat": { "command": "npx", "args": ["-y", "@serpstat/serpstat-mcp-server"], "env": { "SERPSTAT_API_TOKEN": "YOUR_TOKEN_HERE" } } } }

  5. Restart the AI client and test the connection: "Show me domain info for example.com".

You can also open the setup page from the Serpstat sidebar: Integrations and Tools → Serpstat MCP.

Available Tool Categories

  1. Domain analysis (domain): Domain info, competitors, keywords a domain ranks for, top pages, domain history, unique keywords between domains, and market research by category. Example: "Find competitors for mysite.com in Google US."

  2. Keyword research (keywords): Related keywords, search suggestions, keyword overview with volume and CPC, top-100 SERP results, keyword competitors, and intent-based filtering. Example: "Find commercial intent keywords for 'email marketing' with difficulty under 40."

  3. Backlink analysis (backlinks): Backlink summary, active and lost backlinks, referring domains, anchors, top pages by backlinks, backlink intersection between competitors, and threat backlinks. Example: "Find domains linking to both competitor1.com and competitor2.com but not to my site."

  4. URL analysis (url): Traffic and keywords for URL patterns, URL competitors, keywords a URL ranks for, and missing keywords (gaps vs. competitors). Example: "What keywords do my competitors rank for that this URL doesn't?"

  5. Site audit (audit): Start, stop, and configure full site audits. Get results by issue category, compare across audit reports, and retrieve lists of pages with specific errors. Example: "Start a site audit for mysite.com and show me all high-priority errors."

  6. Rank tracking (rt): List rank tracker projects, check parsing status, get keyword SERP history and URL ranking history over time. Example: "Show me ranking history for my tracked keywords over the last 30 days."

  7. Project management (projects): Create, list, and delete Serpstat projects — the containers for rank tracking, audits, and historical data. Example: "Create a new project for client.com named Q2 Campaign."

  8. One-page audit (page-audit): Scan individual URLs with JavaScript rendering, track scan progress, get detailed on-page issue reports, and compare results across scans. Example: "Scan this landing page and show me all SEO errors."

  9. Credits monitoring (credits): Check API credit usage and remaining quota across all modules, and audit credit stats. Example: "How many API credits do I have left?"

Pro Tip: Run a Full Competitor Content Gap Workflow in One Conversation

Serpstat MCP holds conversation context between requests — use this to chain a complete research workflow without re-entering data.

  1. Start with: "Who are the top SEO competitors for mysite.com in Google US?" — get the competitor list.

  2. Follow up: "Show me keywords where competitor.com ranks positions 1–10 that mysite.com is missing."

  3. Filter down: "From those missing keywords, show only ones with search volume above 1,000 and difficulty under 45."

  4. The goal: A prioritized, actionable content gap report — generated in 3 prompts, no tab-switching, no spreadsheet work.

⚠️ Important: Serpstat MCP is available on the Team plan or higher, the same as API access. Each request uses API credits based on the method called. The most credit-intensive operations are site audits (1 credit per page, 10 with JavaScript rendering) and one-page audits (10 credits per scan). Checking your credit balance is free. Most plans allow 1 API request per second. Serpstat MCP works alongside the Serpstat platform — it doesn't replace the full interface.

❓ Frequently Asked Questions

Q: Which AI assistants work with Serpstat MCP?
​A: The HTTP version works with Claude (web, desktop, and mobile) and ChatGPT (web, mobile, and desktop for Windows). The STDIO version works with Claude Desktop, Claude Code, ChatGPT Desktop, Gemini CLI, and Cursor. Other MCP-compatible clients can connect too.
​

Q: Which version should I choose?
​A: Choose HTTP for a quick start, demos, and mobile access — all tools are always available. Choose STDIO for daily work: you can enable only the tool groups you need and save the AI's context window. Your API token also stays on your computer.
​

Q: How do I disconnect an AI client from Serpstat?
​A: Open your profile and go to Connected Apps. The table shows each app, its connection date, IP address, client ID, and last use. Click Revoke Access next to an app, or Revoke all sessions to disconnect all of them. The AI client asks you to authorize again on its next request.
​

Q: Who can add the connector in a Claude Team or Enterprise workspace?
​A: Only the workspace owner can add a custom connector. After that, each team member connects their own Serpstat account.
​

Q: Can I limit which tools are available to the AI?
​A: Yes, in the STDIO version. Set the SERPSTAT_ENABLED_CATEGORIES variable in your config, for example keywords,domain. This reduces context window usage. The HTTP version always provides all tools.
​

Q: Where can I find a prompt example for a specific report?
​A: Open any Site Analysis or Keyword Research report and click API / AI. The MCP / AI tab shows an example for the current report.
​

Q: Is Serpstat MCP a replacement for the Serpstat platform?
​A: No — Serpstat MCP is a conversational interface to the Serpstat API. It automates workflows and surfaces data through AI chat. Full platform features (visual dashboards, report exports, UI-based configuration) remain in the Serpstat platform itself.

Next Steps

Did this answer your question?