Skip to content
MCP server

geo-score

Score how well AI engines can cite a website from 0 to 100, with optional citation checks

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
1.8.4
Listing updated
today

Similar MCP servers

About geo-score

geo-score is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

geo-score measures whether answer engines such as ChatGPT, Perplexity, Gemini and Google AI Overviews can reach, parse, trust and cite a site. A free first level runs 21 tiered checks in five pillars, with three gates and a list of the biggest gaps, against a published, versioned rubric anyone can recompute. It needs no key and no install beyond one command.

Levels two and three use your own API keys: Ask puts a question to OpenAI, Perplexity, Gemini, Anthropic or OpenRouter and records whom each answer cites, and Watch runs a fixed question set weekly to track citations, competitors and sources over time. Citation results are shown beside the score and never added to it.

The README is open about evidence being thin in places and about sponsors never affecting scores. It comes from Jianrun Tech, formerly geo-watch, runs over stdio via PyPI or an mcpb bundle, and has a GitHub Action and a public leaderboard. English and Chinese docs are provided.

Install

Run in a terminal

claude mcp add geo-score --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env PERPLEXITY_API_KEY='<PERPLEXITY_API_KEY>' --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' -- uvx geo-score

Add to claude_desktop_config.json

{
  "mcpServers": {
    "geo-score": {
      "command": "uvx",
      "args": [
        "geo-score"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "PERPLEXITY_API_KEY": "<PERPLEXITY_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "geo-score": {
      "command": "uvx",
      "args": [
        "geo-score"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "PERPLEXITY_API_KEY": "<PERPLEXITY_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "geo-score": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "geo-score"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "PERPLEXITY_API_KEY": "<PERPLEXITY_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "geo-score": {
      "command": "uvx",
      "args": [
        "geo-score"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "PERPLEXITY_API_KEY": "<PERPLEXITY_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "geo-score": {
      "command": "uvx",
      "args": [
        "geo-score"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>",
        "PERPLEXITY_API_KEY": "<PERPLEXITY_API_KEY>",
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • OPENAI_API_KEYOptional. OpenAI key; enables ask and run on that engine.
  • PERPLEXITY_API_KEYOptional. Perplexity key; enables ask and run on that engine.
  • GEMINI_API_KEYOptional. Gemini (Google AI Studio) key; enables ask and run on that engine.
  • ANTHROPIC_API_KEYOptional. Anthropic key; enables ask and run on that engine.
  • OPENROUTER_API_KEYOptional. OpenRouter key; enables ask and run on that engine.
  • GEO_SCORE_WATCH_CONFIGOptional. Path to geo-score-watch.json for run, list_runs, report and diff.
  • OPENAI_API_KEYOptional. OpenAI key; enables ask and run on that engine.
  • PERPLEXITY_API_KEYOptional. Perplexity key; enables ask and run on that engine.
  • GEMINI_API_KEYOptional. Gemini (Google AI Studio) key; enables ask and run on that engine.
  • ANTHROPIC_API_KEYOptional. Anthropic key; enables ask and run on that engine.
  • OPENROUTER_API_KEYOptional. OpenRouter key; enables ask and run on that engine.
  • GEO_SCORE_WATCH_CONFIGOptional. Path to geo-score-watch.json for run, list_runs, report and diff.

What it does

Free readiness score
0 to 100 from 21 checks across five pillars.
Published rubric
Versioned and recomputable by anyone.
Citation checks
Ask engines through your own API keys.
Weekly watch
Track citations against competitors over time.
Biggest gaps first
Shows what to fix and what it is worth.
GitHub Action
Run the score in CI.

Good for

  • Check why AI engines don't cite your site
  • Fix robots.txt rules that block retrieval crawlers
  • Track brand citations week by week
  • Compare against competitors on key questions
  • Add a GEO check to a build pipeline

Pricing

Open source

Free open source; citation checks use your own API keys

geo-score FAQ

Is the score free?

Yes, level 1 needs no key.

Which engines can I query?

OpenAI, Perplexity, Gemini, Anthropic and OpenRouter with your keys.

Is citation data in the score?

No, it is reported beside it, never summed.

What does GEO mean?

Generative Engine Optimization.

Is geo-score free?

Yes. geo-score is open source, so you can use and self-host it for free.

How do I add geo-score to Claude Code?

Run this command in your terminal: claude mcp add geo-score --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env PERPLEXITY_API_KEY='<PERPLEXITY_API_KEY>' --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' -- uvx geo-score

What are the best alternatives to geo-score?

The closest alternatives to geo-score are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Customer Io, Google_search_console and Ads AI Creator MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers