GeoGen MCP Server

The GeoGen MCP (Model Context Protocol) server lets AI assistants like Claude, Cursor, and Windsurf query your LLM visibility data, manage entities, and analyze trends via natural language.

With the MCP server, you can ask your AI assistant questions like “What’s my visibility trend over the last 30 days?” or “Which domains are citing my brand?” and get answers directly from your GeoGen data.

Prerequisites

Node.js v18 or higher
A GeoGen API key: go to your workspace Settings > API Keys to create one

Setup

Claude Desktop
Claude Code
Cursor / Windsurf

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "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 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"

Add to your MCP settings (see each IDE’s docs for the config file 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

Once configured, your AI assistant has access to the following tools:

Read Operations

Tool	Description
`get_entities`	List all tracked websites/entities
`get_workspace`	Workspace usage, limits, and credit balance
`get_workspace_members`	List team members
`get_workspace_tags`	List all tags
`get_models`	Available LLM models
`get_entity_prompts`	Prompts with visibility and sentiment stats
`get_responses`	LLM responses with mention status
`get_response_details`	Detailed response data including mentions, citations, and 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
`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 connected, try asking your AI assistant:

Visibility Analysis

“What’s the visibility trend for my website over the last 30 days?”

Citation Insights

“Which domains are LLMs citing when they talk about my brand?”

Competitor Intel

“Show me the top competitors for my website”

Search Patterns

“What search queries are LLMs running about my entity?”

More example prompts:

“List all my tracked entities”
“Add a new tracking prompt: ‘What is the best project management tool?’”
“Give me a full SEO report comparing my entity against competitors”
“What’s the sentiment trend for my brand this month?”

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`)

Keep your API key secure. Never commit it to version control or share it publicly.

MCP

​GeoGen MCP Server

​Prerequisites

​Setup

​Available Tools

​Read Operations

​Write Operations

​Example Queries

Visibility Analysis

Citation Insights

Competitor Intel

Search Patterns

​Environment Variables

GeoGen MCP Server

Prerequisites

Setup

Available Tools

Read Operations

Write Operations

Example Queries

Environment Variables