@rankgeo/mcp-server

Model Context Protocol (MCP) server for the RankGeo GEO platform. Exposes 10 tools that let AI agents read workspace, audit, and suggestion data and trigger ingestion, audits, and suggestion status changes.

Install

npm install -g @rankgeo/mcp-server
# or
npx -y @rankgeo/mcp-server

Configure

Generate an API key in the RankGeo dashboard at /dashboard/settings, then add the server to your MCP client config:

{
  "mcpServers": {
    "rankgeo": {
      "command": "npx",
      "args": ["-y", "@rankgeo/mcp-server"],
      "env": {
        "RANKGEO_API_URL": "https://api.rankgeo.ai",
        "RANKGEO_API_KEY": "rgk_your_key_here"
      }
    }
  }
}

For local development, point RANKGEO_API_URL at http://localhost:4000 and run the backend with pnpm dev:backend.

Environment

| Variable | Required | Default | Description | | -------------------- | -------- | ----------------------- | ------------------------------------------------------------ | | RANKGEO_API_KEY | yes | — | Bearer token from the RankGeo dashboard. | | RANKGEO_API_URL | no | http://localhost:4000 | Base URL of the RankGeo backend that hosts /api/mcp/tools. |

Tools

Read-only:

• list_workspaces — list workspaces owned by the authenticated account
• get_workspace — fetch a single workspace by id
• list_suggestions — list suggestions (filterable by status and category)
• get_suggestion — fetch a single suggestion by id
• get_scores — list all audit runs for a workspace
• get_score_breakdown — get the latest completed audit with full breakdown

Side-effecting:

• trigger_ingestion — fire-and-forget re-ingestion of the product site
• trigger_audit — fire-and-forget re-measurement of GenAI visibility
• apply_suggestion — mark a suggestion applied (schedules a ~24h re-audit)
• dismiss_suggestion — mark a suggestion dismissed

Development

pnpm install
pnpm --filter @rankgeo/mcp-server build
pnpm --filter @rankgeo/mcp-server test

The package uses the modern MCP SDK (McpServer + registerTool + StdioServerTransport), Zod 4 .strict() schemas, and returns both content and structuredContent for cross-client compatibility.

License

UNLICENSED — proprietary to RankGeo.