# Briefing Service

Hourly, ranked, structured news briefings for agents and small displays.
Seven briefings (AI, Frontier Labs, Markets, US Sports, European Football,
US News, World News) are re-picked every hour by an LLM editor from ~100
sources, with a lead, ranked stories and research items, one-line summaries,
"why it matters" and key points, plus rendered 480x800 1-bit pages for e-ink.

## Endpoints
- GET https://briefing-service.wholemind.workers.dev/v1/briefings              free: list of briefings and prices
- GET https://briefing-service.wholemind.workers.dev/v1/briefings/{key}/summary   free: headlines + one-line summaries (for widgets/plugins)
- GET https://briefing-service.wholemind.workers.dev/v1/briefings/{key}        one briefing as JSON
- GET https://briefing-service.wholemind.workers.dev/v1/briefings/{key}/pages/{n}.png|bmp  rendered page n (0 = front page, free)
- POST https://briefing-service.wholemind.workers.dev/v1/render                your feeds + persona -> ranked briefing + pages ($0.05, or 10/day on a key)
- POST https://briefing-service.wholemind.workers.dev/mcp                      MCP server (streamable HTTP) with the same data as tools
- OpenAPI: https://briefing-service.wholemind.workers.dev/openapi.json

## Paying
- License key: https://briefing-service.wholemind.workers.dev/billing/checkout (Stripe). Send it as
  "Authorization: Bearer <key>" on any request, including MCP.
- x402: paid routes answer HTTP 402 with payment requirements (USDC on Base);
  pay and retry. Prices are fractions of a cent per request.

## Contact
hello@wholemind.tech