For agents & developers
API & agent discovery
The machine-readable description lives at /openapi.json. This page is its human-readable companion. The Status column tells agents whether an endpoint is live; anything marked Placeholder is advertised for discovery only and should not be relied on.
Endpoints
| Method | Path | Description | Status |
|---|---|---|---|
| GET | /api/health | Service health and subsystem (database) status. | Live |
| GET | /openapi.json | OpenAPI 3.1 description of this surface (service-desc). | Live |
| GET | /.well-known/api-catalog | RFC 9727 API catalog (application/linkset+json). | Live |
| GET | /auth.md | Markdown instructions for agents obtaining an OAuth token. | Live |
| POST | /mcp | Live MCP server (Streamable HTTP, JSON-RPC 2.0). Public read tools; write tools require an OAuth bearer scope. | Live |
| GET | /api/agent/premium | Agent-native premium insights, paid via x402 (onchain USDC). Unpaid requests receive HTTP 402 with payment requirements; settles on Base. | Live |
Content negotiation
Send Accept: text/markdown on the homepage or any /products/:slug page to receive a compact markdown rendering instead of HTML. Responses carry Vary: Accept.
Well-known discovery documents
Advertised via the Link response header and /.well-known/api-catalog. Several are advertised ahead of implementation so agents can branch on the embedded status markers rather than probe blindly.
- /.well-known/openid-configuration— OIDC discovery (live)
- /.well-known/oauth-authorization-server— RFC 8414 (live)
- /.well-known/oauth-protected-resource— RFC 9728 (live)
- /.well-known/mcp/server-card.json— MCP server card (live)
- /.well-known/agent-skills/index.json— Agent skills index