SERPtag MCP Server — Connect AI Tools to Your Rankings

SERPtag Model Context Protocol (MCP)

The Model Context Protocol (MCP) gives your local AI clients like Cursor, Claude Desktop, and VS Code extensions real-time access to your ranking statistics and search volumes.

What is SERPtag MCP?

MCP is an open standard developed by Anthropic that allows local LLMs to securely call specialized tools. Instead of manual copy-pasting or CSV downloads, your AI workspace calls these tools dynamically to fetch rank tracking information.

SERPtag hosts a secure cloud MCP server at: https://mcp.serptag.com/mcp. For local apps that do not support remote HTTP servers, you can bridge connection using our NPM runner.

Requirements

To connect AI assistants to your rankings, you must ensure:

Generating API Keys

Your local configuration loads rankings using secure API credentials.

  1. Generate Key
    Follow Create an API Key on docs.serptag.com, or generate one in Settings > API Keys.
  2. Copy Full String
    Make sure to copy the full string immediately (starts with sk_live_...). It will only be shown once.
  3. Load Config
    Paste the key as the value for the SERPTAG_API_KEY variable in your configuration setup.

Installation

You do not need to install the package globally. Your workspace runs it on-demand via the Node package executor command:

npx -y serptag-mcp-server

Merge the JSON block below into your MCP client config folder. Be sure to replace the placeholder key with your actual live API key:

{
  "mcpServers": {
    "serptag": {
      "command":  "npx",
      "args": [ "-y", "serptag-mcp-server" ],
      "env": {
        "SERPTAG_API_KEY":  "sk_live_your_key_here"
      }
    }
  }
}

Cursor Configuration

Cursor is designed to read remote SSE endpoints natively. To configure it:

  1. Open Cursor and navigate to Settings (Gear icon) > Features > MCP.
  2. Click + Add New MCP Server.
  3. Name the server: serptag
  4. Set type to: SSE
  5. Set URL to: https://mcp.serptag.com/mcp
  6. Click Add Header: key is Authorization, value is Bearer [Your API Key].

Claude Desktop Configuration

Claude Desktop runs local MCP clients. Add the serptag runner inside the server configuration file:

Restart your Claude Desktop application after saving the file to activate the configuration.

VS Code Integration

If you use extensions like Cline, Roo-Code, or Continue in VS Code, append the following block to your local MCP settings workspace:

{
  "servers": {
    "serptag": {
      "command":  "npx",
      "args": [ "-y", "serptag-mcp-server" ],
      "env": {
        "SERPTAG_API_KEY":  "sk_live_your_key_here"
      }
    }
  }
}

Windsurf Configuration

Windsurf utilizes the standard stdio interface. Paste the configuration block inside your Windsurf MCP configuration settings:

Advanced — Remote HTTP

For developers building custom integrations (such as python agents or LangChain scripts) that support direct SSE/HTTP connection protocols, connect using:

{
  "mcpServers": {
    "serptag": {
      "url":  "https://mcp.serptag.com/mcp",
      "headers": {
        "Authorization":  "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Code CLI command: claude mcp add --transport http serptag https://mcp.serptag.com/mcp

Available Tools (v1)

The MCP server exposes 14 read-only actions for querying active rank tracking data:

Tool Description
list_projects List all rank-tracking projects with keyword counts and domain
search_projects Find projects by name or domain
get_project Full details for one project including keywords summary
list_keywords Tracked keywords with current rank, volume, change, and URL
search_keywords Search keywords by text across all or one project
get_keyword One keyword's current rank, volume, movement, and metadata
get_keyword_history Ranking position history over time
get_keyword_volume_history Search volume history chart data
get_top_10_keywords All keywords ranking in positions 1–10
get_project_graph Project performance graph between two dates (YYYY-MM-DD)
get_project_alerts Alert settings and configuration for a project
get_rank_compare Compare keyword ranks across time periods
list_keywords_by_page Keywords grouped by ranking URL (Pages view)
get_account_info Account plan, usage, refresh limits, and subscription stats

Upcoming Write operations
add_keywords Add keywords to a project
create_project Create a new rank-tracking project
refresh_keywords Trigger an on-demand rank refresh
generate_report Generate an SEO ranking report

Example Prompts

Try prompting your AI assistant using these query templates:

Troubleshooting Guide

Click any issue below to view debugging details: