geo-check-mcp
geo-check-mcp
An MCP server that checks whether a website is technically ready to be read and cited by AI search (ChatGPT search, Perplexity, Copilot, Gemini, Claude). It runs over stdio and has no API keys.
AI answers change over time; this tool does not and cannot guarantee that a site will be recommended. It checks the technical factors a site owner controls.
Tools
Tool | Network | What it does |
| no | Lists the 16 crawler user-agents checked (GPTBot, OAI-SearchBot, ChatGPT-User, PerplexityBot, Perplexity-User, ClaudeBot, Claude-SearchBot, Claude-User, Google-Extended, Googlebot, Bingbot, Applebot-Extended, Amazonbot, Meta-ExternalAgent, CCBot, Bytespider) with operator and purpose. |
| no | Evaluates pasted robots.txt text for each crawler and path. Follows RFC 9309: user-agent group merging, a specific group beating |
| yes | Full check of a public site: AI-crawler access, homepage JSON-LD types, |
check_site is polite. It makes about 4 GET requests 1 second apart, sends a declared User-Agent
(GeoCheckBot/0.1 (+mailto:...), which you can change in geo_check.py), obeys robots.txt for its own
user-agent, and fetches only the homepage. It does not spoof crawler user-agents, so CDN or firewall bot
blocking (for example Cloudflare "Block AI bots") is reported as "not checked".
Related MCP server: aeo-mcp
Install and run
pip install -e . # needs Python 3.10+, mcp>=1.2 (works with SDK 1.x FastMCP and 2.x MCPServer)
geo-check-mcp # stdio server
# or: python -m geo_check_mcpClaude Desktop / Cursor config:
{
"mcpServers": {
"geo-check": { "command": "geo-check-mcp" }
}
}Try it with MCP Inspector:
npx @modelcontextprotocol/inspector --cli geo-check-mcp --method tools/list
npx @modelcontextprotocol/inspector --cli geo-check-mcp --method tools/call --tool-name check_site --tool-arg url=https://example.comThe checker also works without MCP: python src/geo_check_mcp/geo_check.py https://example.com --md out.md --json out.json.
Tests
pip install -e '.[test]'
pytest -q # offline: robots parser + stdio protocol self-test
GEO_LIVE_URL=https://example.com pytest -q # also runs one live check_site callUse this as a template for your own MCP server
The layout keeps business logic and the MCP layer apart:
src/geo_check_mcp/
geo_check.py # plain Python, no MCP imports; unit-testable
server.py # ~60 lines: one decorated function per tool
tests/
test_robots.py # logic tests
test_server_stdio.py # starts the server, sends raw JSON-RPC: initialize, tools/list, tools/callTo wrap a REST API, a CSV or Airtable base, or an internal service instead:
Replace
geo_check.pywith a client module (read secrets from environment variables, never hard-code them).In
server.py, write one small@mcp.tool()function per action, with type hints and a docstring. The SDK builds the JSON schema from them.Run slow or blocking I/O in a thread (
anyio.to_thread.run_sync) so the stdio loop stays responsive.Update
test_server_stdio.pywith the new tool names and one offline call each.
License
MIT, see LICENSE.
Available Tools
3 toolscheck_robotsA
Evaluate robots.txt text (no network) for AI crawlers.
Args: robots_txt: full robots.txt content. path: URL path to test, e.g. "/" or "/blog/post". user_agents: crawler tokens to test; defaults to the built-in AI crawler list.
Inputs: robots_txt (required), path, user_agents.
check_siteA
Run the full GEO technical check on a public website (robots.txt AI-crawler access, homepage JSON-LD types, /llms.txt, sitemap, title/description/canonical/h1).
Makes about 4 polite requests (1 s apart, declared User-Agent, obeys robots.txt).
Args: url: site URL, e.g. https://example.com format: "json" (structured report) or "markdown" (adds a human-readable report).
Inputs: url (required), format.
list_ai_crawlersA
List the AI / search crawler user-agents this server checks, with operator and purpose.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
list_ai_crawlers (reference data), check_robots (offline robots.txt evaluation) and check_site (network-based full GEO audit) each have a clearly stated purpose. The only mild overlap is that check_site also covers robots.txt AI-crawler access, so an agent could conceivably pick check_site when it only wanted the robots check, but the offline/online distinction in the descriptions resolves this.
All three names follow a consistent verb_noun snake_case pattern: list_ai_crawlers, check_robots, check_site. The check_ prefix groups the two evaluation tools logically and list_ signals the reference-data tool.
Three tools is on the small side, but the server's scope (GEO/technical crawlability checks) is narrow and each tool earns its place: one reference list, one offline evaluator, one full site audit. Slightly thin but well scoped rather than padded.
The surface covers the core GEO workflow: discovering which crawlers matter, testing robots.txt offline, and running a combined audit of robots.txt, JSON-LD, /llms.txt, sitemap and head tags. Minor gaps exist — no standalone llms.txt or JSON-LD/sitemap check, and no offline HTML inspection — but these are reachable through check_site.
Maintenance
Related MCP Connectors
Unified 15-tool SEO, SERP, clean Markdown & GEO (LLM citation Share-of-Voice) MCP server.
Open-source AI SEO over MCP: audits, ranks, keywords, backlinks + AI visibility (GEO).
6-category AI readiness, Schema.org, robots.txt, /llms.txt & 25k-token audit + auto-fix MCP server
AI search readiness MCP: score a site for ChatGPT/Claude/Perplexity crawlers. 3 free/day.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceMCP server for website SEO + GEO analysis. Scan any URL to get scores across 5 categories (SEO, GEO, Performance, Security, Accessibility) with actionable fix recommendations. Enables AI coding assistants to audit websites and implement fixes autonomously.-
- AlicenseAqualityDmaintenanceAn MCP server that gives AI agents tools to inspect a website's visibility to AI answer engines, including crawler permissions, llms.txt, structured data, on-page signals, and a full 29-check AI-readiness audit.560 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server exposing Generative Engine Optimization tools to any AI agent, enabling checking of llms.txt, auditing robots.txt for AI crawlers, and validating JSON-LD schema.MIT
- AlicenseNot gradedqualityDmaintenanceOpen-source MCP server that audits websites for AI search readiness, providing deterministic scoring (0-100) and prioritized fix lists for metrics like JSON-LD, llms.txt, heading hierarchy, and AI crawler access.1MIT