◎ Discry Score
formester.com
productivity · API
D
0 / 100
DISCOVERY0
COMPREHENSION0
Category leader: 92 (A)
Discry your API →
PRODUCTIVITY · RANK #21 OF 24

Formester is Poor to agents.

Discry independently scored how well an AI agent can discover and understand the Formester 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 · 24/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.Fail
llms.txt qualityThe llms.txt is focused, current, and well under the size budget.Fail
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.Pass
robots.txt AI directivesrobots.txt allows (or explicitly guides) AI crawlers.Pass
SitemapA sitemap so agents can enumerate the docs surface.Partial

Comprehension

55% of score · 76/100
Task-oriented descriptionsEndpoints described by what they accomplish, not just their shape.Pass
Realistic examplesRunnable, real-world request/response examples.Partial
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.Pass
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.Partial
Heading hierarchyClean heading structure agents can navigate.Pass
Markdown docsDocs available as clean markdown, not JS-rendered HTML only.Partial
Token efficiencyDocs are concise enough to fit an agent context window.Pass

What we found

  • An agent that already knows Formester's docs URL is well-served: the v2 REST docs are task-oriented, scoped-permission-aware, and every endpoint leads with method + URL + required scope, then realistic cURL examples with plausible UUIDs and phone/prefill values.
  • Formester is unusually agent-forward at the product level — it ships an official MCP server (app.formester.com/mcp) with OAuth, four tools (read_submission, query_submissions, update_submission, fetch_file), and is listed on both PulseMCP and Glama. An agent looking for a Formester MCP integration will find one.
  • But an agent DISCOVERING Formester cold would struggle: no llms.txt, no llms-full.txt, no OpenAPI/Swagger spec, and no AGENTS.md. The only machine-discovery win is robots.txt (open to all crawlers) and the MCP registry listings.
  • The sitemap (formester.com) covers marketing/template/blog pages but omits the docs subdomain entirely — the API reference on docs.formester.com is invisible to a crawler working from the root sitemap.
  • Error recovery is a genuine strength: error tables pair each message with a cause and fix (e.g. 'implement exponential backoff for 429', 'expires_at must be in the future', 'use Get Form to look up element IDs before constructing prefill_data'), which is exactly the self-correction context agents need.

What to change

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

  1. 01Publish an llms.txt at formester.com/llms.txt (and ideally docs.formester.com/llms.txt) pointing to the API v2 reference, the MCP server guide, and auth/scopes pages — this is the single biggest discovery gap and a quick win that lifts an F-grade discovery score.
  2. 02Expose a public OpenAPI 3.x spec (openapi.json/yaml) for the v2 API. A Postman collection exists but is not machine-consumable the way a hosted OpenAPI document is; this is the highest-weight discovery check (5) and currently a full fail.
  3. 03Add the docs subdomain to sitemap coverage — either a sitemap at docs.formester.com/sitemap.xml or docs entries in the root sitemap — so crawlers index the API reference, not just marketing pages.
  4. 04Resolve request/response naming inconsistency: request/query params are snake_case (form_uuid, prefill_data, expires_at) while response fields are camelCase (createdAt, entryName, submissionsCount). Documenting this convention explicitly (or normalizing) prevents agent field-mapping errors.
  5. 05Add code examples in at least one additional language (Python/JS) beyond cURL, and add 2-3 dedicated end-to-end workflow guides (e.g. 'generate per-recipient survey links: get form → create prefills → create unique links → read submissions') to move the multi-step-workflow check from partial to pass.

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 token (X-FORMESTER-TOKEN header)OAuth2 (MCP server) Error format documented Rate limits documented Pagination documented Idempotency documented

Execution characteristics are documented clearly for a read/write REST API: token auth via X-FORMESTER-TOKEN header (OAuth additionally supported through the MCP server), machine-parseable JSON error bodies ({"message": ...}), an explicit 10-requests/60-seconds-per-token rate limit, and page-number pagination (20/page with a meta object in v2). No idempotency keys are mentioned, which matters for the write endpoints (bulk prefill/unique-link create).

See your own Discry Score.

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

Discry your API — free