mcp-geo

<div align="center"> <h1>🔌 MCP GEO</h1> <p><em>MCP server exposing GEO (Generative Engine Optimization) tools to any AI agent. Check llms.txt, audit robots.txt for AI crawlers, validate JSON-LD schema — all through one MCP interface.</em></p> <p> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a> <a href="https://github.com/josezuma/mcp-geo"><img src="https://img.shields.io/github/stars/josezuma/mcp-geo?style=social" alt="Stars"></a> </p> <p>by <a href="https://brandvirality.com">BrandVirality</a></p>

<p><strong>Author:</strong> <a href="https://github.com/josezuma">Jose Zuma — Expert in AI Visibility</a></p> </div>

---

Tools

Tool	Description
check_llms_txt	Check if a URL/domain has llms.txt and llms-full.txt
audit_robots_for_ai	Check robots.txt for AI crawler allow/block rules
validate_schema	Extract and validate JSON-LD schema.org markup
geo_audit	Full GEO audit combining all three checks

Quick Start

With Claude Desktop

{
  "mcpServers": {
    "geo": {
      "command": "python",
      "args": ["/path/to/mcp-geo/scripts/server.py"]
    }
  }
}

With Claude Code

claude code --mcp python /path/to/mcp-geo/scripts/server.py

With Hermes

# hermes config.yaml
tools:
  mcp:
    geo:
      command: python /path/to/mcp-geo/scripts/server.py

Manual test

# Run all checks on a URL
echo '{"tool":"geo_audit","params":{"url":"https://example.com"}}' | python scripts/server.py

# Check llms.txt only
echo '{"tool":"check_llms_txt","params":{"url":"https://example.com"}}' | python scripts/server.py

Example Output

$ echo '{"tool":"geo_audit","params":{"url":"https://brandvirality.com"}}' | python scripts/server.py
{
  "result": {
    "url": "https://brandvirality.com",
    "domain": "brandvirality.com",
    "llms_txt": {
      "/llms.txt": {"exists": false, "size": 0},
      "/llms-full.txt": {"exists": false, "size": 0}
    },
    "robots": {
      "has_robots_txt": true,
      "ai_crawlers_configured": 0,
      "ai_crawlers_blocked": 0
    },
    "schema": {
      "has_schema": true,
      "schema_count": 3,
      "types_found": ["FAQPage", "ItemList", "Organization"]
    }
  }
}

How This Reuses Sibling Repos

Tool	Data Source
check_llms_txt	Uses the llmstxt.org spec (project 06)
audit_robots_for_ai	Uses ai-crawlers dataset (project 02)
validate_schema	Uses schema-for-ai templates (project 04)
geo_audit	Combines all above + geo-audit-skill (project 03)

Related

• awesome-ai-visibility — Curated AI visibility resources
• ai-crawlers — AI crawler dataset (powers audit_robots)
• geo-audit-skill — URL-level GEO auditing
• schema-for-ai — JSON-LD templates (powers validate_schema)
• llmstxt-gen — llms.txt generator (powers check_llms_txt)
• BrandVirality — AI Visibility Agency

License

MIT © 2026 Jose Zuma / BrandVirality