docs.windsurf.com agentic web readiness
A Score 54 (coverage 40 + breadth 9 + conformance 5). 5 standards observed across 4 of 9 steps; 5 manifests present, 3 errors, 8 warnings. Checked 2026-10-23 04:04:06 UTC. This grades the agent-facing files published at docs.windsurf.com, not the organisation's products.
Coverage by step
Manifests
| Manifest | Result | Findings |
|---|---|---|
Agentic Resource Discovery/.well-known/ard.json | absent HTTP 404 | |
AI Catalog well-known file/.well-known/ai-catalog.json | absent HTTP 404 | |
MCP Server Cards (SEP-2127)/.well-known/mcp/server-card.json | errors |
|
Agent2Agent Protocol/.well-known/agent-card.json | errors |
|
llms.txt/llms.txt | valid |
|
AGENTS.md/AGENTS.md | absent HTTP 404 | |
Agent Skills/.well-known/agent-skills/index.json | valid | |
api-catalog: A Well-Known URI and Link Relation to Help Discovery of APIs/.well-known/api-catalog | absent HTTP 404 | |
AI Crawler User-Agent Tokens in robots.txt/robots.txt | valid |
|
security.txt (RFC 9116)/.well-known/security.txt | absent HTTP 404 | |
auth.md/auth.md | absent HTTP 404 | |
Open Knowledge Format/okf/index.md | absent HTTP 404 |
What an agent can call
- MCP endpoint
https://docs.windsurf.com/mcp(http) — from/.well-known/mcp.json - MCP endpoint
https://docs.windsurf.com/mcp(http), tools: search_windsurf_docs, query_docs_filesystem_windsurf_docs — from/.well-known/mcp/server-card.json - A2A agent Windsurf Docs at
https://docs.windsurf.com/, skills: Codeium - llms.txt: Windsurf Docs, 125 links, llms-full.txt present
- robots.txt AI policy: unlisted crawlers partial
Standards observed
- Agent2Agent Protocol https://docs.windsurf.com/.well-known/agent-card.json
- llms.txt https://docs.windsurf.com/llms.txt
- Content Signals Policy https://docs.windsurf.com/robots.txt
- Agent Skills https://docs.windsurf.com/.well-known/agent-skills/index.json
- AI Crawler User-Agent Tokens in robots.txt
Cheapest next steps
- Agentic Resource Discovery: a catalog at /.well-known/ard.json lets agents discover your APIs, MCP servers and data in one fetch
- AGENTS.md: instructions for coding agents working on or with the site
- api-catalog: A Well-Known URI and Link Relation to Help Discovery of APIs: an RFC 9727 linkset pointing at your OpenAPI description
Agent pre-flight & practical readiness
Preferred mode: mcp (fallback a2a). Call the MCP endpoint at https://docs.windsurf.com/mcp first. Do not scrape the HTML when a tool can answer.
Fetch: POST https://docs.windsurf.com/mcp POST a JSON-RPC tools/list, or server/discover on the 2026-07-28 revision, before reading HTML.
Practical readability: exa_parsable yes, markdown negotiation no, render none, HTML quality none.
AI crawler posture: open_to_all · Assistant access: OpenAI partial, Anthropic partial, Google partial, Perplexity partial, Exa partial.
Readiness subscores: reach 20/20, readability 10/30, capabilities 27/35, conformance 5/15, total 62/100, grade B.
How the grade is made
+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. Errors are specification violations; warnings are best-practice gaps. Only public paths are fetched, without credentials, so standards that need a login (skipped in the probe) are not counted either way. The same report is the validate_manifest tool on the MCP server.
JSON · Markdown · probe rules