# docs.warp.dev: agentic web grade B

Score 33 (coverage 20 + breadth 3 + conformance 10); 3 standards observed across 2 of 9 steps; checked 2026-10-18T23:42:54Z. This grades the agent-facing files published at docs.warp.dev, not the organisation's products.

## Manifests

| Manifest | Path | Result | Errors | Warnings |
| --- | --- | --- | --- | --- |
| Agentic Resource Discovery | /.well-known/ard.json | absent |  |  |
| AI Catalog well-known file | /.well-known/ai-catalog.json | absent |  |  |
| MCP Server Cards (SEP-2127) | /.well-known/mcp.json | errors | $schema missing (required: https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json); name must be reverse-DNS with exactly one slash, e.g. com.example/weather; version missing | Content-Type is application/json; charset=utf-8; SEP-2127 says serve application/mcp-server-card+json; pre-final card shape (url/transport/tools); the final SEP-2127 card uses name, version, description and remotes[]; description is over 100 characters; remotes missing: a card with no remotes gives clients nothing to connect to |
| Agent2Agent Protocol | /.well-known/agent-card.json | absent |  |  |
| llms.txt | /llms.txt | valid |  |  |
| AGENTS.md | /AGENTS.md | absent |  |  |
| api-catalog: A Well-Known URI and Link Relation to Help Discovery of APIs | /.well-known/api-catalog | absent |  |  |
| AI Crawler User-Agent Tokens in robots.txt | /robots.txt | valid |  | no AI crawler token named (GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, ...); the policy for them is whatever User-agent: * says (partial); no Agentmap: line (optional convention pointing agents at /.well-known/ard.json) |
| security.txt (RFC 9116) | /.well-known/security.txt | absent |  |  |
| auth.md | /auth.md | absent |  |  |

## Standards observed

- llms.txt: https://docs.warp.dev/llms.txt (https://agenticweb.wiki/protocols/llms-txt/)
- Content Signals Policy: https://docs.warp.dev/robots.txt (https://agenticweb.wiki/protocols/cloudflare-content-signals-policy/)
- AI Crawler User-Agent Tokens in robots.txt: undefined (https://agenticweb.wiki/protocols/ai-crawler-tokens-robots/)

## Cheapest next steps

1. Agentic Resource Discovery: a catalog at /.well-known/ard.json lets agents discover your APIs, MCP servers and data in one fetch (https://agenticweb.wiki/protocols/ard/)
2. AGENTS.md: instructions for coding agents working on or with the site (https://agenticweb.wiki/protocols/agents-md/)
3. api-catalog: A Well-Known URI and Link Relation to Help Discovery of APIs: an RFC 9727 linkset pointing at your OpenAPI description (https://agenticweb.wiki/protocols/api-catalog-rfc9727/)

## Rubric

+10 per lifecycle step with a standard observed, counting manifests that validate or that the probe rule for the standard recognises (a valid MCP server card counts for MCP; max 90); +3 per observed standard beyond the first two (max 15); conformance +15 (+10 with one manifest) minus 5 per agent-facing manifest with errors, never below 0 (security.txt is reported, not scored). A+ >= 60, A >= 45, B >= 30, C >= 20, D >= 10.

JSON: https://agenticweb.wiki/check/docs.warp.dev/index.json · badge: https://agenticweb.wiki/badge/docs.warp.dev.svg