npm package: @geogenio/mcp-server
Description: MCP server for GeoGen LLM SEO tracking platform
Latest version: 1.0.1

# 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):

```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 Code

```bash
claude mcp add geogen -- npx -y @geogenio/mcp-server
```

Then set the environment variables:
```bash
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):

```json
{
  "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`) |