# AIO.GEO Protocol

> AI Search Readiness OS: measure, fix (dry-run), rescore, prove.
> We do not sell LLM rankings. Nobody can measure them honestly. We sell what can be measured: structure, accessibility, and receipts to prove it.

## Canonical host
- Primary production: https://www.aiogeoprotocol.com
- Apex https://aiogeoprotocol.com redirects 308 to www
- Deploy alias https://aio-geo.vercel.app remains technical only (not brand)


## Official agent interfaces
- Custom GPT Auditor: https://www.aiogeoprotocol.com/gpt
- OpenAPI (ChatGPT Actions): https://www.aiogeoprotocol.com/openapi-gpt.json
- OpenAPI 3.1 full: https://www.aiogeoprotocol.com/openapi.json
- Cursor MCP: `npx -y @aio-geo/mcp-server@0.3.3` (registry: io.github.DigitalCurrensy/aio-geo)
- Public audit API: POST https://www.aiogeoprotocol.com/api/v1/public/audit
- Public brief API: POST https://www.aiogeoprotocol.com/api/v1/public/brief
- API catalog (RFC 9727): https://www.aiogeoprotocol.com/.well-known/api-catalog
- MCP server card: https://www.aiogeoprotocol.com/.well-known/mcp/server-card.json
- Agent skills: https://www.aiogeoprotocol.com/.well-known/agent-skills/index.json
- Markdown: send Accept: text/markdown on any public HTML page
- Agent registration: https://www.aiogeoprotocol.com/auth.md
- OAuth AS metadata (RFC 8414): https://www.aiogeoprotocol.com/.well-known/oauth-authorization-server
- Protected resource (RFC 9728): https://www.aiogeoprotocol.com/.well-known/oauth-protected-resource
- WebMCP: navigator.modelContext.registerTool on every page (Crema-class tools, polyfill, UI actuation). Catalog: https://www.aiogeoprotocol.com/api/v1/public/webmcp-tools
- Mystery shopper: https://www.aiogeoprotocol.com/webmcp
- Studio: https://www.aiogeoprotocol.com/webmcp/studio
- Installer: https://www.aiogeoprotocol.com/webmcp/install

## Primary surfaces
- [Home audit](https://www.aiogeoprotocol.com/): Free structural readiness scan
- [Executive brief](https://www.aiogeoprotocol.com/brief): Dual SEO + AIO client brief for agencies
- [Brief share](https://www.aiogeoprotocol.com/inspect/brief/{slug}): Co-branded public client view
- [Docs](https://www.aiogeoprotocol.com/docs): Public methodology, mathematical formulas, and glossary
- [Whitepaper](https://www.aiogeoprotocol.com/whitepaper): Technical framework (aliases to /protocol)
- [CLI / MCP](https://www.aiogeoprotocol.com/cli): Operator install
- [Tools](https://www.aiogeoprotocol.com/tools): Enterprise utility suite (23+ modules)
- [OPS](https://www.aiogeoprotocol.com/vanguard): Operator control room
- [Agency](https://www.aiogeoprotocol.com/agency): Multi-client roster (auth)
- [Admin](https://www.aiogeoprotocol.com/admin): Founder control room (FOUNDER_EMAILS)
- [Paths map](https://www.aiogeoprotocol.com/paths): Persona routing and full surface index
- [First HTML](https://www.aiogeoprotocol.com/first-html): Public hangout. Pin a live receipt to the wall. Not a ranking.
- [WebMCP shopper](https://www.aiogeoprotocol.com/webmcp): Can an agent finish audit / book / checkout. Not a ranking.
- [WebMCP studio](https://www.aiogeoprotocol.com/webmcp/studio): Filmable compare / highlight / book demo.
- [WebMCP installer](https://www.aiogeoprotocol.com/webmcp/install): Drop-in quote + consult tools for law / HVAC / clinic.
- [OpenAPI 3.1](https://www.aiogeoprotocol.com/openapi.json): Public REST for agents and Custom GPTs
- [llms-full](https://www.aiogeoprotocol.com/llms-full.txt): Expanded documentation map
- [Contact](https://www.aiogeoprotocol.com/contact): Ops desk
- [Custom GPT Auditor](https://www.aiogeoprotocol.com/gpt): Conversational AI Search Readiness (on-site; ChatGPT store listing unpublished)
- [Integrations](https://www.aiogeoprotocol.com/integrations): Webhooks, CRM, Google Indexing, CI gate
- [Pulse](https://www.aiogeoprotocol.com/pulse): Live system health
- [Merkle seal SVG](https://www.aiogeoprotocol.com/api/v1/badge/seal.svg): Viral trust badge endpoint
- [About](https://www.aiogeoprotocol.com/about) · [Team](https://www.aiogeoprotocol.com/team) · [Company](https://www.aiogeoprotocol.com/company)

## Operator stack (Grok-native workflow)
- Built with Grok Build. Independent product: AIO.GEO Protocol by Digital Currensy Inc.
- Recommended IDE: Cursor with MCP @aio-geo/mcp-server
- Not an official xAI product. Not an LLM ranking product.

## Developer packages
- CLI: `npx @aio-geo/cli@0.3.4 audit example.com`
- MCP: `npx -y @aio-geo/mcp-server@0.3.3`
- TypeScript SDK: `@aio-geo/sdk`
- Action: `@aio-geo/action` (score gate with real scores only)
- Python: `pip install aio-geo==0.3.1` then `AioGeoClient().audit("example.com")`

## Mathematical core and native engines (names only)
- Sinkhorn Cosine Optimal Transport Solver: min <P,C> + eps H(P)
- BPE Token Entropy: H_BPE(X) = -sum P(x) log2 P(x)
- DOM AST Parser and ARIA Landmark Extractor
- Closed-Loop Self-Healing AST Code Patcher
- Cryptographic Merkle DAG and ZK-HMAC Proof Seals
- Dual-engine executive brief synthesizer
- Sales calibration grade (relative industry curve + spatial penalty)
- Omega Sales Engine v0.3.2: Proxy ROI leakage, token eviction, hallucination risk, voice fencing
- Commercial brief modules (Traffic Hemorrhage / Citation Velocity BYOK locks)
- Search Intelligence BYOK (Perplexity, Ahrefs, Google Ads, Reddit)

## Methodology
- Score: geo-heuristic-v3.5 (0-100, five pillars)
- Technical 25% · Content 25% · Schema 20% · Authority 20% · Presentation 10%
- Dry-run default on all write paths
- Recipe (public formulas) vs Kitchen (private solvers and DB plane)

## API (public)
- POST /api/v1/public/audit
- POST /api/v1/public/apply
- POST /api/v1/public/brief
- GET /api/v1/public/wall (First HTML opt-in pins only)
- POST /api/v1/public/wall (pin a just-run receipt; fail closed)
- GET /api/v1/public/proof/{id}
- POST /api/contact

## Legal and social
- Terms: https://www.aiogeoprotocol.com/terms
- Privacy: https://www.aiogeoprotocol.com/privacy
- X: https://x.com/AIOGEO
- GitHub (private monorepo): https://github.com/DigitalCurrensy/aio-geo-protocol

## Skill registry (agents)
- Workspace skills live in monorepo `.grok/skills/` (not on npm)
- Catalog: exports/skills/00_SKILL_CATALOG.md
- New: aio-geo-sales-engine, aio-geo-intelligence-byok

## Version
- llms.txt: v1.13.0
- App: v10.0.0 · CLI 0.3.4 · MCP 0.3.3 · SDK/action 0.3.1 · method geo-heuristic-v3.5


## Enterprise data paths
- Global Entity Ledger: anonymized structural fingerprints (domain hash, industry, score)
- CRM: Salesforce Lead + HubSpot Contact with dead-letter queue
- Refusal lock applies to all agent-facing copy

## Live integrations (5)
1. Custom GPT Auditor: https://www.aiogeoprotocol.com/gpt
2. Agency webhooks: /integrations
3. Salesforce + HubSpot BYOK: /integrations
4. Google Indexing API BYOK: /integrations
5. GitHub Actions score gate: /integrations