◎ Discry Score
adyen.com
payments · API
B
0 / 100
DISCOVERY0
COMPREHENSION0
Category leader: 94 (A)
Discry your API →
PAYMENTS · RANK #12 OF 25

Adyen is Good to agents.

Discry independently scored how well an AI agent can discover and understand the Adyen 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 · 64/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.Partial
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.Partial
robots.txt AI directivesrobots.txt allows (or explicitly guides) AI crawlers.Fail
SitemapA sitemap so agents can enumerate the docs surface.Fail

Comprehension

55% of score · 87/100
Task-oriented descriptionsEndpoints described by what they accomplish, not just their shape.Pass
Realistic examplesRunnable, real-world request/response examples.Pass
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.Pass
Capability boundariesClear limits — what the API can and cannot do.Partial
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.Partial

What we found

  • Adyen's llms-full.txt is a 28MB concatenation of every public markdown page — the most comprehensive single-document agent resource found in payments, though its size (>50KB) means it requires RAG chunking rather than single-prompt consumption.
  • AGENTS.md files exist in multiple Adyen GitHub repos (adyen-flutter, adyen-node-api-library, and all other SDK repos) — a clear investment in AI-assisted development.
  • Every documentation page is available as native markdown by appending .md to the URL (e.g., docs.adyen.com/online-payments.md), making the entire docs site agent-consumable.
  • No robots.txt on docs.adyen.com (404) — agents won't find explicit guidance on crawling permissions for the documentation subdomain.
  • The llms.txt is well-structured with 136 sections covering all Adyen products but is more of a site-wide index than an API-focused guide.

What to change

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

  1. 01Add robots.txt to docs.adyen.com explicitly allowing AI bots and referencing the llms.txt file.
  2. 02Create a trimmed, API-focused llms.txt variant (under 50KB) that covers only REST API integration patterns rather than all product documentation.
  3. 03Add sitemap.xml to docs.adyen.com listing API documentation pages specifically.
  4. 04Add .well-known/mcp.json to formalize the MCP discovery path for agents.
  5. 05Document specific rate limits publicly — current docs reference limits but don't provide numbers.

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 key (x-api-key header)Basic Auth (web service user) Error format documented Rate limits documented Pagination documented Idempotency documented

Well-documented authentication via API key header, structured error responses, cursor-based pagination in balance platform APIs. Rate limits not publicly documented with specific numbers. Idempotency supported via Idempotency-Key header.

See your own Discry Score.

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

Discry your API — free