These paths are not paid. They are not rate-limited with the payment gate. Use them to discover tools and check process health. Payment smoke GET /v1/tools/ping is not a product tool; see /docs/tools/ping.

Liveness

GET /health

Process liveness. Does not touch Postgres or the facilitator.

/health

{
  "service": "magent",
  "status": "ok"
}

Readiness

GET /ready

Readiness. Requires Postgres and the payment_attempts table.

/ready

{
  "status": "ready"
}

Catalog

GET /v1/catalog

Machine-readable tools, prices, parameters, errors, and example responses.

/v1/catalog

OpenAPI

GET /openapi.json

OpenAPI 3.1 document for agents and HTTP clients.

/openapi.json

llms.txt

GET /llms.txt

Compact agent onboarding: identity, pay handshake, playbooks, and doors to /v1/catalog and /llms-full.txt.

/llms.txt

x402 well-known

GET /.well-known/x402

x402scan discovery manifest: version, resource URLs, ownership proofs.

/.well-known/x402

sitemap.xml

GET /sitemap.xml

Indexable URLs for the public site, docs, and machine doors.

/sitemap.xml

llms-full.txt

GET /llms-full.txt

Index of per-tool markdown URLs, pay handshake, MCP config, and an @x402/fetch example.

/llms-full.txt