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

Braintree is Poor to agents.

Discry independently scored how well an AI agent can discover and understand the Braintree 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 · 43/100
OpenAPI specA machine-readable OpenAPI/Swagger spec agents can parse.Partial
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.Fail
AGENTS.mdAn AGENTS.md that tells coding agents how to build on the API.Fail
.well-known/mcp.jsonA discoverable MCP manifest at a well-known path.Fail
MCP registryThe API is listed in a public MCP registry.Fail
robots.txt AI directivesrobots.txt allows (or explicitly guides) AI crawlers.Partial
SitemapA sitemap so agents can enumerate the docs surface.Partial

Comprehension

55% of score · 69/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.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

  • Braintree has a dedicated llms.txt (at developer.paypal.com/braintree/llms.txt) with structured sections and the same markdown URL hint as PayPal (/md/ prefix), making docs agent-accessible.
  • As a PayPal subsidiary, Braintree inherits the parent's robots.txt but has no independent discovery signals — no own domain, no AGENTS.md, no MCP server.
  • Braintree uses GraphQL as its primary API (not REST), with the schema publicly available on GitHub, but this format is less standard for agent tooling than OpenAPI.
  • No dedicated Braintree MCP server exists in any registry — agents must use PayPal's broader toolkit or integrate manually.
  • Tutorial-focused documentation with step-by-step guides (Drop-in UI, Hosted Fields) provides good workflow coverage for agents learning to integrate.

What to change

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

  1. 01Publish a Braintree-specific MCP server or ensure the PayPal Agent Toolkit explicitly covers Braintree GraphQL operations.
  2. 02Create an OpenAPI-equivalent description of the GraphQL schema that agents can more easily parse (or a GraphQL-specific llms.txt section).
  3. 03Add AGENTS.md to the braintree/graphql-api GitHub repo to guide coding agents.
  4. 04Document rate limits publicly — agents have no way to know when they'll hit throttling.
  5. 05Add idempotency documentation for the GraphQL API to help agents avoid duplicate operations.

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 (public key + private key)Client token (for frontend) Error format documented Rate limits documented Pagination documented Idempotency documented

Authentication via public/private key pair for server-side and client tokens for frontend. GraphQL API uses structured error responses. Rate limits not publicly documented. Pagination via cursor in GraphQL. 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