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

Kloudle is Good to agents.

Discry independently scored how well an AI agent can discover and understand the Kloudle 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 · 57/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.Pass
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.Pass
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 · 90/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.Partial
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.Pass

What we found

  • An agent looking for Kloudle finds it easily and can start using it with zero setup: a well-structured llms.txt, a valid /.well-known/mcp.json declaring the search/get tools, an AI-bot-friendly robots.txt, and live listings on Smithery (83/100), the MCP Registry, and claudemarketplaces all point to the same streamable-HTTP MCP endpoint with 50 free calls/day and no API key.
  • Kloudle is architected agent-first rather than retrofitted: the /agents page documents the exact search()/get() call pattern, ships a copy-paste MCP config, and returns SHA256-verified, cosign-signed static binaries with structured exit codes so an agent can branch logic without parsing stdout. This is why comprehension scores an A (90).
  • The scan penalizes Kloudle on discovery signals that assume a traditional REST API: there is no OpenAPI/Swagger spec (the highest-weighted discovery check) because the interface is MCP tools plus binaries, and no llms-full.txt. This drops discovery to a D (57) despite the surface itself being highly agent-usable.
  • Capability boundaries are exceptionally clear for an early-stage product: the docs explicitly distinguish the 7 agent scanners / 24 checks from the full platform's 681 AWS checks, label every platform surface as Live / In development / Roadmap, and state rate limits and read-only IAM scoping up front — an agent will rarely discover a limit by failing.
  • No AGENTS.md exists in the github.com/Kloudle organization, a missed quick win for a company whose entire positioning is building software with coding agents.

What to change

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

  1. 01Publish an OpenAPI 3.x spec for the MCP tool surface (or at minimum a machine-readable tool schema linked from mcp.json) — even a two-operation (search, get) spec would flip the single highest-weighted discovery check from fail to pass and is the largest single score lever available.
  2. 02Add an AGENTS.md to the primary public repo in github.com/Kloudle (e.g. the scanner-binary or MCP-server repo) covering how a coding agent should discover, download, verify, and run the scanners — a near-zero-effort fix that matches Kloudle's own AI-software-factory positioning.
  3. 03Generate an llms-full.txt that expands the existing llms.txt with the full search/get call semantics, the 24 checks per scanner, exit-code contract, and the waitlist POST schema, so an agent can absorb the complete surface in one fetch.
  4. 04Add explicit error-recovery guidance to the /agents docs beyond exit-code meanings: what an agent should DO on exit code 2 (re-check IAM credentials / required read-only permissions) and exit code 3 (retry with backoff), turning error documentation from descriptive into actionable.
  5. 05Document a second end-to-end workflow beyond the happy-path Discover-Get-Run (e.g. multi-scanner sweep, or promoting a finding to the ledger) so multi-step workflow coverage moves from a single flow to the 2-3 chained guides agents rely on.

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.

No API key (open MCP)Cloud provider read-only IAM credentials (for scanner binaries)x402 USDC micropayment (paid MCP tier) Error format documented Rate limits documented Pagination documented Idempotency documented

Kloudle's agent surface is an MCP server (search/get tools at mcp.kloudle.dev) that distributes signed static AWS scanner binaries, not a conventional REST API. Execution characteristics are unusually well documented for agents: structured exit codes (0 clear, 1 misconfig, 2 auth failure, 3 network error), JSON/JSONL output with severity and remediation hints, a clear rate limit (50 get calls/day per IP free; $0.001/call paid via x402), and read-only IAM permission scoping. No pagination or idempotency semantics are documented (search/get is a simple discovery pattern that does not require them). No OpenAPI spec exists because the product is an MCP + binary distribution model rather than a REST API.

See your own Discry Score.

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

Discry your API — free