docs.devin.ai agentic web readiness

A+ Manifest validity: 60% (3/5 valid, 3 errors, 10 warnings) · Surface score 70 (coverage 50 + breadth 15 + conformance 5). 9 standards observed across 5 of 9 steps; 5 manifests present (+ robots.txt), 3 errors, 10 warnings. Checked 2026-10-25 17:45:11 UTC. This grades the agent-facing files published at docs.devin.ai, not the organisation's products.

Badge for a README: ![agentic web grade](https://agenticweb.wiki/badge/docs.devin.ai.svg) · JSON · Markdown · Re-check now

Coverage by step

Manifests

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json",
  "name": "ai.devin.docs/docs",
  "title": "Docs",
  "version": "1.0.0",
  "description": "Docs and what it offers to agents",
  "websiteUrl": "https://docs.devin.ai/",
  "icons": [
    {
      "src": "https://docs.devin.ai/icon.png",
      "mimeType": "image/png",
      "sizes": [
        "180x180"
      ]
    }
  ],
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://docs.devin.ai/mcp",
      "supportedProtocolVersions": [
        "2025-11-25",
        "2025-06-18",
        "2025-03-26"
      ]
    }
  ]
}

{
  "name": "Docs",
  "description": "Docs and what it offers to agents",
  "version": "1.0.0",
  "provider": {
    "organization": "Docs",
    "url": "https://docs.devin.ai/"
  },
  "documentationUrl": "https://docs.devin.ai/AGENTS.md",
  "supportedInterfaces": [
    {
      "url": "https://docs.devin.ai/a2a",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "1.0"
    }
  ],
  "url": "https://docs.devin.ai/a2a",
  "protocolVersion": "1.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": [
    "text/plain"
  ],
  "defaultOutputModes": [
    "text/plain"
  ],
  "skills": [
    {
      "id": "answer",
      "name": "Answer questions",
      "description": "Answer questions about Docs.",
      "tags": [
        "qa"
      ],
      "examples": [
        "What does Docs do?"
      ]
    }
  ],
  "securitySchemes": {},
  "securityRequirements": []
}

What an agent can call

• MCP endpoint https://docs.devin.ai/mcp (http) — from /.well-known/mcp.json
• MCP endpoint https://docs.devin.ai/mcp (http), tools: search_devin_docs, query_docs_filesystem_devin_docs — from /.well-known/mcp/server-card.json
• A2A agent Devin Docs at https://docs.devin.ai/, skills: cognitionai
• llms.txt: Devin Docs, 270 links, llms-full.txt present
• robots.txt AI policy: no AI crawler tokens named; unlisted crawlers allowed on public paths (subpaths disallowed under User-agent: *)
• Endpoint check (a2a https://docs.devin.ai/): pseudo_endpoint_html (agent card url points to the HTML homepage rather than a callable A2A endpoint)

Standards observed

• Agent2Agent Protocol https://docs.devin.ai/.well-known/agent-card.json
• llms.txt https://docs.devin.ai/llms.txt
• AGENTS.md https://docs.devin.ai/AGENTS.md
• Content Signals Policy https://docs.devin.ai/robots.txt
• Agent Skills https://docs.devin.ai/.well-known/agent-skills/index.json
• Markdown for Agents https://docs.devin.ai/
• api-catalog: A Well-Known URI and Link Relation to Help Discovery of APIs https://docs.devin.ai/.well-known/api-catalog
• MCP Server Cards (SEP-2127)
• Model Context Protocol

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 (emerging spec — publish only if you run the underlying endpoints; generate via MCP template({"id": "ard", "domain": "docs.devin.ai"}))
2. security.txt (RFC 9116): RFC 9116 contact and expiry, read by agents and people
   Generate starter /.well-known/security.txt for docs.devin.ai

   Contact: mailto:security@docs.devin.ai
   Expires: 2027-09-20T22:03:31Z
   Canonical: https://docs.devin.ai/.well-known/security.txt
   Preferred-Languages: en
   Policy: https://docs.devin.ai/security-policy
   

Agent pre-flight & practical readiness

Preferred mode: mcp (fallback agent_skills). Call the MCP endpoint at https://docs.devin.ai/mcp first. Do not scrape the HTML when a tool can answer.

Fetch: POST https://docs.devin.ai/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 yes, render markdown_native, HTML quality high, first content at byte 0.

AI crawler posture: open_to_all · Assistant access: OpenAI allowed, Anthropic allowed, Google allowed, Perplexity allowed, Exa allowed.

Readiness subscores: reach 20/20, readability 28/30, capabilities 23/35, conformance 5/15, total 76/100, grade A+.

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). Lifecycle grade: A+ >= 60, A >= 45, B >= 30, C >= 20, D >= 10. Strict 100-point composite (subscores.total_100 / subscores.grade_100): reach_and_policy (20) + readability (30) + capabilities (35) + conformance (15), where A+ >= 80, A >= 65, B >= 45, C >= 28, D >= 15. 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