/llms.txt— a compact, sectioned index of every endpoint (and/llms-full.txtfor the full reference). Point an agent here first.- OpenAPI 3.1 at
/openapi.json— import into any codegen, or let an agent read it. - An MCP server — gives your agent typed tools, with no glue code.
Discover the API as an agent
Add the MCP server
Install the Conduit MCP server and your agent gets tools likescreen_macro,
get_latest_observations, cross_country, rates_analytics, economic_calendar, and
observation_provenance.
Claude Code
Conventions agents should know
- Read-only: every endpoint is
GET. - Envelope:
{ "data": ..., "meta": { "request_id", "api_version", "pagination" } }. - Pagination: cursor-based — follow
meta.pagination.next_cursorwhilehas_moreis true. - Rights-aware:
/v1/public/*returns only redistribution-safe data. - Stable error codes:
bad_request,not_found,unauthorized,forbidden,rate_limited,internal_error.