WunderCorp Field Notes

Service discovery

Agents Cannot Buy What They Cannot Discover

Why llms.txt, OpenAPI, product catalogs, and clear service identity matter in machine-readable markets.

4 min read

A human can arrive at a website, infer the company’s purpose from the headline, and ask sales for clarification. An agent needs a more explicit welcome. It must know what the service is, which operations exist, how they are priced, and what credentials or payments are required.

WunderCorp MPP uses machine-readable surfaces such as llms.txt, OpenAPI metadata, product catalogs, and service identity files to make agent-payable capabilities legible. Discovery is not an SEO ornament in this context. It is the first step in a transaction.

The descriptions should name outcomes rather than internal implementation. An agent can reason about purchasing an implementation pack or application preview more easily than it can reason about a vaguely branded “AI endpoint.” The schema should reveal what the next step can consume.

Doku can provide the deeper documentation behind those discovery files, while BuilderStudio CLI can make generation repeatable. The short machine-readable index and the long human-readable explanation should agree, or the product has merely created two sources of uncertainty.

When payment is required, ArgentShell helps developers test how the discovered service responds with an HTTP 402 challenge and how the paid request succeeds. The agent should not encounter an economic surprise after it has already selected the service.

Machine-readable markets will favour products that introduce themselves clearly. The WunderCorp approach treats discovery, documentation, pricing, and execution as one chain because an autonomous customer cannot be expected to fill the gaps with a meeting.