# Agent Disco

> Grade any public URL for AI-agent discoverability. A scanner that fetches the handful of URIs agent frameworks actually read (robots.txt, llms.txt, /.well-known/ai-plugin.json, /.well-known/agent.json, OpenAPI specs, SDK signals, registry presence) and returns a letter grade A–F with a per-category breakdown.

Agent Disco is a self-service tool for web operators who care about how AI agents — LangChain tool-use loops, OpenAI operators, Claude's computer use, MCP clients — experience their site. Submit a URL, get a grade in under a minute, read the fix hints, re-scan. The grade is a sum of fixed-weight checks in a published catalogue, so the score is auditable.

## Start here

- [Homepage](https://agentdisco.io/): submit a URL for grading
- [Check catalogue](https://agentdisco.io/checks): every check the scanner runs, with fix hints
- [API docs (Swagger UI)](https://agentdisco.io/api/docs): interactive reference for the public API
- [About the scanner (/bot)](https://agentdisco.io/bot): User-Agent string, fetch paths, how to allow-list or block us
- [llms-full.txt](https://agentdisco.io/llms-full.txt): this file, expanded — the full check catalogue inline

## API endpoints

- POST /api/v1/scans — submit a URL (rate-limited per IP)
- GET /api/v1/scans/{id} — poll the result of a submitted scan
- GET /api/v1/websites/{host} — latest completed grade for a host
- GET /api/v1/websites/{host}/badge.svg — embeddable SVG grade badge
- GET /api/v1/checks — full check catalogue as JSON
- OpenAPI spec: https://agentdisco.io/api/v1/openapi.json

## Discoverability manifests (dogfood)

- [/.well-known/ai-plugin.json](https://agentdisco.io/.well-known/ai-plugin.json) — ChatGPT-plugin manifest
- [/.well-known/agent.json](https://agentdisco.io/.well-known/agent.json) — A2A AgentCard
- [/.well-known/mcp.json](https://agentdisco.io/.well-known/mcp.json) — MCP descriptor (bridges to the HTTP API; native JSON-RPC endpoint is on the roadmap)

## Operator

Agent Disco is operated by Starsol Ltd (England, company 06002018). The scanner fetches public URIs on-demand only — no background crawler, one clearly-identified User-Agent.

- [Terms](https://agentdisco.io/terms)
- [Privacy](https://agentdisco.io/privacy)
- [Contact form](https://agentdisco.io/contact)