GeoGen MCP Server

MCP (Model Context Protocol) server for the GeoGen LLM SEO tracking platform. Lets AI assistants query your LLM visibility data, manage entities, and analyze trends via natural language.

Setup

1. Get Your API Key

Go to your GeoGen workspace Settings > API Keys and create a new key.

2. Configure Your AI Client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "geogen": {
      "command": "npx",
      "args": ["-y", "@geogenio/mcp-server"],
      "env": {
        "GEOGEN_API_KEY": "your-api-key-here",
        "GEOGEN_BASE_URL": "https://api.geogen.io"
      }
    }
  }
}

Claude Code

claude mcp add geogen -- npx -y @geogenio/mcp-server

Then set the environment variables:

export GEOGEN_API_KEY="your-api-key-here"
export GEOGEN_BASE_URL="https://api.geogen.io"

Cursor / Windsurf

Add to your MCP settings (see each IDE's documentation for the config location):

{
  "geogen": {
    "command": "npx",
    "args": ["-y", "@geogenio/mcp-server"],
    "env": {
      "GEOGEN_API_KEY": "your-api-key-here",
      "GEOGEN_BASE_URL": "https://api.geogen.io"
    }
  }
}

Available Tools

Read Operations

| Tool | Description | |------|-------------| | get_entities | List all tracked websites/entities | | get_workspace | Workspace usage, limits, credit balance | | get_workspace_members | List team members | | get_workspace_tags | List all tags | | get_models | Available LLM models | | get_entity_prompts | Prompts with stats for an entity | | get_responses | LLM responses with mention status | | get_response_details | Detailed response data (mentions, citations, fanouts) | | get_citations | Top cited domains for an entity | | get_citation_details | Detailed URLs for a cited domain | | get_competitors | Competitor visibility leaderboard | | get_citations_trend | Daily citation trend for top cited domains over time | | get_visibility_trend | Visibility trend over time | | get_sentiment_trend | Sentiment trend over time | | get_query_fanouts | Web search queries LLMs perform |

Write Operations

| Tool | Description | |------|-------------| | create_entity | Create a new tracked entity (consumes credits) | | add_prompts | Add single or bulk prompts to an entity | | delete_prompt | Delete a prompt |

Example Queries

Once configured, you can ask your AI assistant things like:

• "List all my tracked entities"
• "What's the visibility trend for entity X over the last 30 days?"
• "Show me the top competitors for my website"
• "Which domains are LLMs citing when they talk about my brand?"
• "What search queries are LLMs running about my entity?"
• "Add a new tracking prompt: 'What is the best project management tool?'"
• "Give me a full SEO report comparing my entity against competitors"

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | GEOGEN_API_KEY | Yes | Your GeoGen workspace API key | | GEOGEN_BASE_URL | Yes | GeoGen API URL (https://api.geogen.io) |