Read-only API

A small HTTP contract over the same public Event projection used by the site.

V1 alpha · JSON · No newsroom access

Endpoints

GET /api/v1/events?limit=20&cursor=…GET /api/v1/events/{id}GET /api/v1/events/{id}/timeline

List pagination uses an opaque cursor and a maximum page size of 50. Event IDs are stable UUIDs. A missing or ineligible Event returns the same 404 response.

Try the public read

curl -sS 'https://readepoch.co/api/v1/events?limit=5'

The response is cacheable public data. The API has no authentication, mutation or route into the local newsroom.

Response contract

{
  "object": "list",
  "data": [{ "id": "…", "label": "…", "verification_state": "UNVERIFIED" }],
  "next_cursor": "v1.…"
}

Errors use {"error": {"code": "…", "message": "…"}}. Unsupported methods return 405. Edge abuse protection may return 429; it is approximate and is not an accounting quota.

MCP developer preview

No MCP server or registry package is available yet. The planned adapter will remain thin and map tools to this API contract; it will not connect to the private board. Until an end-to-end client test passes, Epoch does not advertise MCP as live.

Ask about developer access