apexseo-geo-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| X402_PAY_TO | No | Base Mainnet USDC payout address (eip155:8453). Defaults to 0x0d25A44f74868eCE53B305C97139CF4B62963410. | |
| CDP_API_KEY_ID | Yes | CDP API key ID required for production x402 facilitator verification (fail-closed enforcement in lib/payment.ts). | |
| CDP_API_KEY_SECRET | Yes | CDP API key secret required for production x402 facilitator verification (fail-closed enforcement in lib/payment.ts). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Keyless live-site Technical SEO, AI-Crawler (robots.txt / llms.txt), GEO/AEO & JSON-LD citation auditor powered by ApexSEO Elite v2026.6. geo_health and geo_pricing are free; audit tools settle per-call in Base Mainnet (eip155:8453) USDC ($0.01-$0.05) via x402 v2.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| geo_healthA | Free diagnostic check returning live service uptime, supported AI crawler matrix, x402 payment configuration (Base USDC payTo and CDP facilitator readiness), and SSRF protection status. Call this or geo_pricing first before running paid live-site audits. |
| geo_pricingA | Free pricing manifest listing all ApexSEO GEO audit endpoints, Base Mainnet (eip155:8453) USDC prices ($0.01-$0.05), endpoint paths, and MCP Streamable HTTP connection details. Ideal sibling to geo_health before dispatching paid calls. |
| ai_crawler_auditA | Live-fetches a domain's /robots.txt, /llms.txt, /llms-full.txt, /sitemap.xml, and /.well-known/{x402,mcp,agent-card.json} files, returning a per-bot permission matrix (GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, PerplexityBot, Google-Extended, Bingbot, Applebot-Extended, CCBot), AI-crawler readiness score (0-100), and ICE fixes. Use geo_page_audit for HTML/TTFB signals or schema_citation_check for JSON-LD validation. |
| geo_page_auditA | Performs a comprehensive live technical + Generative Engine Optimization (GEO/AEO) audit of any URL: measures TTFB, redirect chain, X-Robots-Tag, meta robots, canonical/hreflang, compression & security headers, title/meta/OpenGraph, H1-H3 question-heading density, structured lists/tables, empty CSR-shell detection, image alt coverage, E-E-A-T trust signals, composite geoScore (0-100), and ApexSEO Elite ICE action plan. Pair with ai_crawler_audit for site-wide robots.txt/llms.txt or geo_competitor_compare for rival benchmarking. |
| schema_citation_checkA | Extracts and validates all embedded application/ld+json blocks (including @graph trees) on a live page, flags syntax errors and missing AI-citation properties for Organization, WebSite, SoftwareApplication, Product, Article, FAQPage, and WebPage entities, scores schema completeness (0-100), and outputs a ready-to-paste JSON-LD @graph patch customized from detected metadata. |
| geo_competitor_compareA | Runs parallel live page GEO audits and AI-crawler (robots.txt / llms.txt) checks across your targetUrl and 1-3 competitorUrls, computing exact win/loss deltas across geoScore, AI-crawler readiness, TTFB speed, schema depth, question headings, and llms.txt coverage, plus a ranked ICE counter-strategy roadmap. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| apexseo_elite_strategist | World-class 2026 Technical SEO, AI Overviews (GEO/AEO), E-E-A-T, and ICE roadmap strategist system prompt sourced from SwarmScribe. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool targets a distinct layer: service health, pricing, crawler-file audit, per-page audit, schema validation, and competitor benchmarking. The only real overlap is geo_competitor_compare, which composes the same audits as geo_page_audit and ai_crawler_audit, but its comparative/delta framing and the cross-references in descriptions make the boundary clear. geo_health and geo_pricing are both free pre-flight tools but return clearly different content.
All names are snake_case with a domain-prefix + action-suffix shape (health, pricing, audit, check, compare), which is readable and predictable. Minor deviation: four tools carry the geo_ prefix while ai_crawler_audit and schema_citation_check do not, slightly breaking the pattern.
Six tools is well within the ideal 3-15 range and each one earns its place: two free pre-flight tools plus four distinct audit capabilities. No redundant or filler tools are present.
The surface covers the full audit lifecycle from discovery (health/pricing) through crawler, page, schema, and competitive analysis, with clear guidance on which to call first. Gaps are minor: no remediation/apply step (schema_citation_check only emits a patch), no batch or multi-URL auditing, and no historical/report export.