◎ Discry Score
upstash.com
infrastructure · API
C
0 / 100
DISCOVERY0
COMPREHENSION0
Category leader: 98 (A)
Discry your API →
INFRASTRUCTURE · RANK #43 OF 68

Upstash is Needs Work to agents.

Discry independently scored how well an AI agent can discover and understand the Upstash 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 · 52/100
OpenAPI specA machine-readable OpenAPI/Swagger spec agents can parse.Fail
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.Fail
.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 · 91/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.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.Partial

What we found

  • Upstash has the strongest agent-resource investment in this cohort: a dedicated /docs/agent-resources section with CLI, MCP server, Skills, and llms.txt documentation — explicitly designed for AI agent consumption
  • The llms-full.txt at 2.5MB provides comprehensive markdown content covering every page in the docs — excellent for deep agent comprehension but the primary llms.txt at 115KB is still too large for quick orientation
  • Multi-step workflow documentation is exceptional: the Workflow product inherently documents chaining operations with step-by-step guides, retries, and error handling built into the product design
  • No OpenAPI specification is publicly available despite having a REST API for Redis, QStash, Vector, and the Developer API — a significant gap for automated agent integration
  • The robots.txt allows all bots but does not include explicit AI bot signals like Content-Signal headers

What to change

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

  1. 01Publish an OpenAPI spec for the Developer API (management endpoints for Redis, QStash, Vector databases) — this is the highest-weight discovery check and would significantly boost the score
  2. 02Add .well-known/mcp.json at the root domain with tool declarations pointing to the official MCP server — connects the strong MCP ecosystem presence to a standard discovery path
  3. 03Create a concise API-focused llms.txt (<10KB) at the root domain that covers core REST API patterns across Redis, QStash, and Vector — the current 115KB /docs/llms.txt is too large for quick agent orientation
  4. 04Add AGENTS.md to the upstash/upstash-redis or upstash/mcp-server repos explaining how coding agents should integrate with Upstash services

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_keybearer_token Error format documented Rate limits documented Pagination documented Idempotency documented

Bearer token authentication via REST API tokens. Error responses documented with HTTP status codes. Rate limits and flow control extensively documented for QStash. Pagination supported. Dedicated agent-resources section with CLI, MCP server, and Skills documentation.

See your own Discry Score.

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

Discry your API — free