Skip to main content

Serpstat MCP — AI-Powered SEO Workflows

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 is a Model Context Protocol server that connects AI assistants — Claude and Gemini — directly to Serpstat's SEO database. Instead of opening dashboards, exporting spreadsheets, and switching tabs, you type a request in natural language and the AI executes it using live Serpstat data. Domain analysis, keyword research, competitor gaps, backlink audits, rank tracking, site audits — all available through a single conversational interface.


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 all 65 Serpstat API methods through natural language: The MCP server exposes domain, keyword, backlink, URL, project, rank tracker, site audit, and one-page audit tools — all accessible by describing what you need.


Getting Started

  1. Make sure you have Node.js 18.0.0 or higher installed. Download it from nodejs.org if needed.

  2. In your Serpstat account, go to Profile and copy your API token. API access requires the Team plan or higher.

  3. Install the MCP server globally via npm: npm install -g @serpstat/serpstat-mcp-server

  4. Open your Claude Desktop configuration file:
    macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    Windows: %APPDATA%/Claude/claude_desktop_config.json

  5. Add the Serpstat MCP server entry to your config file: { "mcpServers": { "serpstat": { "command": "npx", "args": ["-y", "@serpstat/serpstat-mcp-server"], "env": { "SERPSTAT_API_TOKEN": "YOUR_TOKEN_HERE" } } } }

  6. Restart Claude Desktop. Serpstat MCP tools will now be available in your Claude conversations.

  7. Test the connection by typing: "Show me domain info for example.com". If you receive SEO data, the setup is complete.


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 requires the Team plan or higher for API access. Most Serpstat plans have a rate limit of 1 request per second — sufficient for most workflows. Different operations consume different credit amounts: domain keyword lookups = 1 credit per result row; site audits = 1 credit per page (10 credits with JavaScript rendering); one-page audits = 10 credits per scan. The server will warn you before executing high-credit operations. Serpstat MCP is a productivity tool that works alongside the Serpstat platform — it is not a replacement for the full platform interface.


❓ Frequently Asked Questions

Q: Which AI assistants are compatible with Serpstat MCP?
A: Serpstat MCP works with Claude Desktop (Anthropic) and Gemini CLI. Any MCP-compatible AI client can also connect to the server.

Q: How long does setup take?
A: Under 5 minutes. You need Node.js 18+, Claude Desktop or Gemini CLI, and your Serpstat API token. No developer experience is required.

Q: Can I limit which tools are available to the AI?
A: Yes — set the SERPSTAT_ENABLED_CATEGORIES environment variable in your config to enable only specific categories (e.g., keywords,domain). This reduces context window usage and focuses the AI on specific tasks. By default, all 65 tools across 9 categories are enabled.

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?