Docs

Endpoints

Every address: what it returns, in what format, and when it changes.

Every address is public and read-only, and none needs a key. The events come first: they are facts, and open. The issue and the whole archive are free to read under the terms. All are served from https://griffinbrief.com.

AddressFormatReturnsUpdates
Events: the open layer
/v1/eventsJSONThe events behind the stories, as facts under ODC-By: date, title, summary, place, corroboration tier, source count. Takes limit, cursor, as_of, since, until, iso3 and category.On every request.
/event/{id}JSONOne event by its id, as it stood at as_of when that is given.On every request.
The latest issue and the archive
/latest.jsonJSONThe latest issue: its theme and every story, with every field in the schema.Within five minutes of an issue being published.
/issues/{n}.jsonJSONIssue number n, in the same shape. n runs from 1 to 4 today. Every issue is here, in full.A new number appears when an issue is published.
/schema/issue.jsonJSON Schema 2020-12The schema both files above validate against.Only when the site is deployed.
/brief.mdMarkdownThe latest issue: the theme, then each story's headline, section, place and dek.On every request.
/story/{slug}.mdMarkdownOne story: the body up to 3,000 words, the Griffin Read, key takeaways, what to watch, uncertainty and sources.On every request.
/v1/storiesJSONPublished stories, newest first, 50 a page: slug, rank, section, place, headline, dek, licence. Takes limit (to 100), cursor and as_of, which reaches back seven days. With a key, each story also carries lens_scores.On every request.
/feed.xmlRSS 2.0The latest issue only, one item per story: title, link, dek, publish time, plate.On every request.
/llms.txtTextThe index: what this is, the date and size of the latest issue, and the addresses in these docs.On every request.
/sitemap.xmlXMLEvery published story's address, with its publish time.On every request.
MCP
/api/mcp/httpMCP, streamable HTTPA Model Context Protocol server, read-only, no key. 3 tools: griffin_latest, griffin_story, griffin_search. Each returns stories as slug, rank, section, place, headline and dek.On every call.
/.well-known/mcp/server.jsonJSONThe server card: the endpoint above and each tool's input schema.Only when the site is deployed.
How the Brief is made
/method.jsonJSONHow the Brief is made: its sources, its cut-off times, and what is not running yetEvery 5 minutes

Limits, per client address per minute: 30 requests to the feeds, 60 to the markdown files, /llms.txt and /event, 60 to the MCP server, 30 to /v1. A refusal is a 429 with a Retry-After header. /latest.json, /issues/{n}.json and /schema/issue.json are static and not counted.