Start with the agent reference
Agents should read llms.txt for routing and llms-full.txt for the complete product reference. OpenAPI is a contract reference for authorized Skill and connector sessions, not a self-serve developer signup surface.
Authorized agent entry points
Bri is available through authorized Skill, CLI, and MCP connector flows.
Bri turns RSS and Atom Subscriptions into source-backed Newspaper and Podcast Briefings. This page collects the machine-readable contracts agents need after they have a Bri-issued session or connector token; it is not an open self-serve developer platform.
Authenticate through Bri
Use Bri-issued Skill Session bearer tokens for /api/v1 and OAuth bearer tokens with scope mcp:use for the MCP connector. Access is tied to signed-in Bri users and approved connector flows.
Use the MCP connector
The MCP surface is intentionally narrow: manage Subscriptions, create Briefings, check status, and return public links.
Understand cost and limits
Bri is in early validation. Current availability, limits, and paid-tier status are machine-readable for agents.
Error recovery contract
Public JSON endpoints return structured errors with stable codes and messages. Agents should retry transient 429 and 5xx failures with exponential backoff, poll Briefing status after creation, and avoid retrying validation errors until inputs change.