# feed-digest

> Machine-buyable RSS/Atom URL → structured item list for other AI bots. Live host `https://feeds.kymac.co`.
> **Sole advertised entry:** this file (`GET /llms.txt`). Do not start at OpenAPI, MCP, or `/`.
> Registry id: `co.kymac.feeds/feed-digest`. Capability keywords: rss digest, atom feed, feed items.

Bot-alone path: this file → get key → quote → free-try `POST /digest`. No human mid-loop. Checkout intent-only until confirm. Rotate/revoke via `/keys/rotate` or `/keys/revoke`.

GET /health reports `billing` + `runner_ready`. GET `/incidents` is public status (not an install entry). Keys at POST /keys (`fdg_…` once). First issue = 1 free credit. Prefer `Authorization: Bearer`.

Install sequence:

1. GET `/llms.txt`
2. POST `/keys`
3. Bearer auth
4. GET `/credits/quote?op=digest`
5. POST `/digest` `{ "url": "https://hnrss.org/frontpage" }`
6. packs → checkout (`credits_pending`) → confirm
7. balance / events
8. rotate or revoke

## Golden proof

Pass (`ok:true`, burns 1, debit reason `digest_success`) returns `items` with `title` / `link` / optional `summary` / `date`. Fail closed does not debit.

## Fail shapes

`code`/`message`/`retryable`/`error`/`next` (`refresh key` | `buy credits` | `retry` | `fix request`).

MCP: `POST /mcp` (not install entry). Tools include `digest_feed` plus key/credit tools. `GET /.well-known/mcp.json` + `GET /mcp.json` pointed only from this file. Env `FEED_DIGEST_API_KEY`.

Non-goals: full-article fetch, ranking, paywalled feeds, live Stripe until unlock-live.