MAGENT

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. Payment smoke GET /v1/tools/ping is not a product tool; see /docs/tools/ping. Not a medical device. Not a diagnosis or dosing recommendation.

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

llmstxt.org door: identity, catalog, OpenAPI, well-known, and /llms-full.txt. Served on the site and API hosts.

/llms.txt

x402 well-known

GET /.well-known/x402

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

/.well-known/x402

APIs.json

GET /.well-known/apis.json

APIs.json 0.24 index: OpenAPI, docs, x402, catalog, and llms.txt. Served on the site and API hosts.

/.well-known/apis.json

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, and an @x402/fetch example.

/llms-full.txt