◎ Discry Score
dm-drogerie-markt.com
commerce · API
D
0 / 100
DISCOVERY0
COMPREHENSION0
Category leader: 95 (A)
Discry your API →
COMMERCE · RANK #17 OF 21

dm-drogerie-markt is Poor to agents.

Discry independently scored how well an AI agent can discover and understand the dm-drogerie-markt 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 · 57/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.Partial
Error-recovery guidanceDocumented failure modes and how to recover from them.Fail
Answer-first formatThe answer leads; preamble does not bury it.Pass
Capability boundariesClear limits — what the API can and cannot do.Fail
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.Pass
Token efficiencyDocs are concise enough to fit an agent context window.Pass

What we found

  • An agent looking for dm can actually find and connect to it: dm ships an OFFICIAL remote MCP server (https://mcp.dm.de/mcp) listed in the official MCP Registry, PulseMCP, and Glama, with copy-paste setup for Claude Code, Claude Desktop, VS Code, and Cursor — a deliberate agent-first bet rare for a bricks-and-mortar retailer.
  • The dm MCP landing page is genuinely task-oriented: beyond describing its two tools (Search, Product Details) it publishes a rich gallery of end-user jobs (allergy/ingredient checks, vegan filters, nutrition comparisons, 'dupe' finders) framed as what an agent can accomplish, not just the interface.
  • There is NO traditional API discovery layer: no OpenAPI/Swagger spec, no valid llms.txt (dm.de/llms.txt silently returns the SPA homepage HTML), no llms-full.txt, no .well-known/mcp.json, and no AGENTS.md in the dm-drogeriemarkt GitHub org — so any agent expecting standard machine-readable discovery files comes up empty.
  • An agent hitting an error is on its own: the docs document zero capability boundaries — no rate limits, no error format, no 'what this API cannot do', and no error-recovery guidance — so limits are discoverable only by failing.
  • Documentation is clean and token-efficient: the entire offering is understandable from a single well-structured, cleanly-scrapeable page in well under 5,000 tokens — but it is German-only and thin on per-tool parameter/response detail.

What to change

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

  1. 01Add a valid llms.txt (and ideally llms-full.txt) at mcp.dm.de covering the MCP endpoint, the two tools, and the core product-search flow — this is the single highest-leverage discovery fix and directly lifts both the llmsTxt and llmsTxtQuality checks.
  2. 02Publish a machine-readable tool/interface reference (an OpenAPI spec for any REST surface, or at minimum a documented JSON schema for the Search and Product Details tool inputs/outputs) so agents get realistic request/response examples with concrete values rather than only natural-language prompt ideas.
  3. 03Document capability boundaries and error recovery: rate limits, request size limits, the error response shape, and 'if you get X, do Y' guidance for the top failure cases (e.g. no results, malformed query). This is currently the biggest comprehension gap.
  4. 04Serve a .well-known/mcp.json (and/or fix dm.de/llms.txt so it stops returning the homepage) so standards-based agent discovery resolves cleanly at the domain root.
  5. 05Add an AGENTS.md to the primary public repo and include the mcp.dm.de docs pages in a sitemap so the agent surface is crawlable and discoverable outside the MCP registries.

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.

none (open remote MCP server) Error format documented Rate limits documented Pagination documented Idempotency documented

dm exposes an official remote MCP server (https://mcp.dm.de/mcp, streamable-http, no auth required) with two tools — semantic product Search and Product Details. Execution characteristics (error format, rate limits, pagination, idempotency) are not documented; tool schemas are delivered at runtime via the MCP protocol rather than in written docs.

See your own Discry Score.

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

Discry your API — free