Free endpoints

Ops

These paths are not paid. They are not rate-limited with the payment gate. Use them to discover tools and check process health.

Liveness

GET /health

Process liveness. Does not touch Postgres or the facilitator.

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

GET /ready

Readiness. Requires Postgres and the payment_attempts table.

{
  "status": "ready"
}

GET /v1/catalog

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

GET /openapi.json

OpenAPI 3.1 document for agents and HTTP clients.

GET /llms.txt

Plain-text onboarding: discover, pay, call. Includes example JSON.

GET /.well-known/x402

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

GET /sitemap.xml

Indexable URLs for site, docs, catalog, OpenAPI, llms, and well-known.

GET /llms-full.txt

Expanded llms.txt with per-tool params, curl, and Cursor mcp.json.