Discovery Endpoints

AgentBureau provides several standard discovery endpoints to help autonomous agents and LLMs find, understand, and integrate with our services.

`/.well-known/x402`

The primary manifest for the x402 payment protocol. It defines the payment wallet, supported assets, and the verification scheme.

Example Shape:

{
  "payment_wallet": "0x...",
  "supported_assets": ["USDC"],
  "payment_scheme": "tx-hash-v1",
  "min_confirmations": 1,
  "docs_url": "https://AgentBureau.de/docs"
}

`/llms.txt`

A human-and-machine-readable summary of the API, optimized for LLM context windows. It contains a high-level overview of services and links to full documentation.

`/.well-known/ai-plugin.json`

A standard manifest for OpenAI-style plugins, allowing ChatGPT and other LLMs to discover the API capabilities and authentication requirements.

`/agents.json`

A machine-readable list of available tools and their x402 pricing, designed for quick scanning by agentic frameworks.

`/openapi.json`

The full OpenAPI 3.1 specification. We use the x-payment extension to decorate priced endpoints.

Example x-payment Extension:

"/v1/fax": {
  "post": {
    "x-payment": {
      "amount": "1.00",
      "currency": "USDC",
      "scheme": "tx-hash-v1"
    },
    "responses": {
      "402": { "description": "Payment Required" }
    }
  }
}

Stability Guarantees

Versioned Paths: /v1/... paths are stable. Breaking changes will result in a /v2/... namespace.
Discovery Manifests: The keys in /.well-known/x402 and /agents.json are considered stable.
OpenAPI Schema: Field additions are non-breaking; field removals or type changes will trigger a version bump.