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.
| Address | Format | Returns | Updates |
|---|---|---|---|
| Events: the open layer | |||
/v1/events | JSON | The 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} | JSON | One event by its id, as it stood at as_of when that is given. | On every request. |
| The latest issue and the archive | |||
/latest.json | JSON | The latest issue: its theme and every story, with every field in the schema. | Within five minutes of an issue being published. |
/issues/{n}.json | JSON | Issue 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.json | JSON Schema 2020-12 | The schema both files above validate against. | Only when the site is deployed. |
/brief.md | Markdown | The latest issue: the theme, then each story's headline, section, place and dek. | On every request. |
/story/{slug}.md | Markdown | One story: the body up to 3,000 words, the Griffin Read, key takeaways, what to watch, uncertainty and sources. | On every request. |
/v1/stories | JSON | Published 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.xml | RSS 2.0 | The latest issue only, one item per story: title, link, dek, publish time, plate. | On every request. |
/llms.txt | Text | The index: what this is, the date and size of the latest issue, and the addresses in these docs. | On every request. |
/sitemap.xml | XML | Every published story's address, with its publish time. | On every request. |
| MCP | |||
/api/mcp/http | MCP, streamable HTTP | A 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.json | JSON | The server card: the endpoint above and each tool's input schema. | Only when the site is deployed. |
| How the Brief is made | |||
/method.json | JSON | How the Brief is made: its sources, its cut-off times, and what is not running yet | Every 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.