# geo-score

> geo-score is an open-source MCP server for marketing and seo. Score how well AI engines can cite a website from 0 to 100, with optional citation checks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Repository:** https://github.com/jianruntech/geo-score
- **MCP Registry name:** io.github.jianruntech/geo-score
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [Customer Io](https://ai-powered.com/mcp/customer-io): Customer Io is a freemium MCP server for marketing and seo.
- [Google_search_console](https://ai-powered.com/mcp/google-search-console-8): Google_search_console is a freemium MCP server for web search and scraping.
- [Ads AI Creator MCP](https://ai-powered.com/mcp/ads-ai-creator-mcp): Ads AI Creator MCP is a paid MCP server for marketing and seo.
- [Zovo QR Code Maker](https://ai-powered.com/mcp/zovo-qr-code-maker): Zovo QR Code Maker is an MCP server for marketing and seo.
- [Agentzia](https://ai-powered.com/mcp/agentzia): Agentzia is a freemium MCP server for marketing and seo.
- [Email Spam Tester](https://ai-powered.com/mcp/email-spam-tester): Email Spam Tester is a free MCP server for communication.

---
Source: https://ai-powered.com/mcp/geo-score
