Public read
These endpoints are public. Send Accept: text/markdown on HTML pages to get a markdown twin. Discovery documents live under /.well-known/.
GET
/api/v1/catalog
List live listings. Add ?q= to search, ?page= and ?limit= to page.
GET
/api/v1/catalog/{slug}
One live listing as JSON, including the official URL and markdown twin.
GET
/api/v1/health
Process health for monitors and the API catalog status link.
GET
/openapi.json
OpenAPI 3.1 description of the public catalog.
POST
/mcp
Streamable HTTP MCP server. Tools: search_catalog, get_listing, list_categories.
Errors and versions
Unknown API paths and missing listings return application/problem+json (RFC 9457) with a machine-readable code, detail, and a hint. Canonical routes live under /api/v1/. /api/catalog and /api/health are v1 aliases and send API-Version: 1. Breaking changes will ship as /api/v2. Before an alias or version goes away, responses include Deprecation and a Sunset date at least 90 days out.
More documents
Maker write APIs stay behind the MakeItLast login cookie. Do not POST a listing for someone else.