◎ Discry Score
docker.com
devtools · API
B
0 / 100
DISCOVERY0
COMPREHENSION0
Category leader: 96 (A)
Discry your API →
DEVTOOLS · RANK #12 OF 39

Docker is Good to agents.

Discry independently scored how well an AI agent can discover and understand the Docker API from what’s public — not whether it’s usable. Below: every signal we checked, what’s costing the score, and what to change.

Discry your API — freeView the docs ↗

SCORED UNDER RUBRIC 1.2 · A full re-launch under Discry Score 2.5 — a new behavioral instrument, not comparable to these scores — is in progress.

Discovery

45% of score · 95/100
OpenAPI specA machine-readable OpenAPI/Swagger spec agents can parse.Pass
llms.txtAn llms.txt index that points agents to the docs that matter.Pass
llms.txt qualityThe llms.txt is focused, current, and well under the size budget.Pass
llms-full.txtA full-text bundle agents can load in one request.Pass
AGENTS.mdAn AGENTS.md that tells coding agents how to build on the API.Pass
.well-known/mcp.jsonA discoverable MCP manifest at a well-known path.Fail
MCP registryThe API is listed in a public MCP registry.Pass
robots.txt AI directivesrobots.txt allows (or explicitly guides) AI crawlers.Pass
SitemapA sitemap so agents can enumerate the docs surface.Pass

Comprehension

55% of score · 78/100
Task-oriented descriptionsEndpoints described by what they accomplish, not just their shape.Partial
Realistic examplesRunnable, real-world request/response examples.Partial
Multi-step workflowsDocs that chain calls into complete jobs an agent can follow.Pass
Error-recovery guidanceDocumented failure modes and how to recover from them.Partial
Answer-first formatThe answer leads; preamble does not bury it.Partial
Capability boundariesClear limits — what the API can and cannot do.Pass
Naming consistencyConsistent, predictable naming across endpoints.Pass
Heading hierarchyClean heading structure agents can navigate.Pass
Markdown docsDocs available as clean markdown, not JS-rendered HTML only.Pass
Token efficiencyDocs are concise enough to fit an agent context window.Pass

What we found

  • Docker is one of the most AI-agent-friendly platforms scanned: explicit Content-Signal ai-train=yes and ai-input=yes in robots.txt, well-structured llms.txt with MCP endpoint reference, and a comprehensive llms-full.txt with 374 indexed sections
  • The llms.txt explicitly references an MCP endpoint at mcp-docs.docker.com/mcp and links to markdown versions of every documentation page, making agent consumption seamless
  • AGENTS.md exists in docker/docker-agent repo with detailed coding agent guidance including build/test/lint commands and validation requirements
  • OpenAPI specs are publicly available for both Docker Hub API (downloadable YAML) and Docker Engine API (swagger.yaml on GitHub), though the Engine spec is in an archived repo
  • Over 100 multi-step guides covering languages, frameworks, AI, testing, and deployment workflows provide exceptional workflow documentation for agents

What to change

Prioritized by impact on discoverability. You (or your docs platform) deploy these — Discry never touches your API.

  1. 01Add .well-known/mcp.json at docs.docker.com pointing to the MCP endpoint at mcp-docs.docker.com/mcp for standardized discovery
  2. 02Consolidate OpenAPI specs under a single discoverable path (e.g., docs.docker.com/openapi.yaml) rather than spreading across GitHub repos and separate API reference pages
  3. 03Add AGENTS.md to the main docker/docs or moby/moby repos, not just docker-agent — coding agents working with Docker's APIs need guidance beyond the agent builder tool
  4. 04Add idempotency documentation for Docker Hub API operations that modify state

Execution coverage · INFORMATIONAL, UNSCORED

Whether an agent can actually complete a call and recover from errors is the deeper Audit layer — documented here, but not part of the Discry Score.

api_keyoauth2✓ Error format documented✓ Rate limits documented✓ Pagination documented✕ Idempotency documented

Docker Engine API is a RESTful API with versioned endpoints. Docker Hub API provides OpenAPI spec with downloadable YAML. Auth via personal access tokens or OAuth. Rate limits documented for Docker Hub pulls. Pagination supported. No idempotency key documentation found.

See your own Discry Score.

Drop your API docs URL. See what an agent sees — in 60 seconds, free.

Discry your API — free