# fetch.li

Everyday UK answers as HTTP. Every successful GET leads with `ok`, `answer`, and `say`.

- Site: https://fetch.li
- API: https://api.fetch.li (also reverse-proxied at /v1 on the apex)
- MCP: https://api.fetch.li/mcp (streamable HTTP, also https://fetch.li/mcp)
- Legal: Tidalux Ltd, England and Wales 17019367, ICO ZC091301
- Email: hello@fetch.li (product). legal@tidalux.io (company).
- Developed by Connor O'Driscoll (https://connorodriscoll.com). Powered by Tidalux Ltd (https://tidalux.io).
- Family: Tidalux Ltd may call this API first-party. fetch.li is not a WaveSites plan.

## MCP

- Transport: streamable HTTP POST to `/mcp`. Same Caddy, TLS, body cap, and shield as REST.
- Auth: the same fetch.li Bearer key as REST. No key means the free demo limits below.
- Tools: one per catalogue GET id, named `fetch_<id>`. Families: sky, weather, life, uk, money, tools, check.
- Not tools (on purpose): vibe classify, account routes, mail routes.
- `GET /v1` lists every endpoint machine-readably (method, path, title, category, auth).

## Contract

- `answer`: the cell a spreadsheet would keep
- `say`: a sentence you could read aloud
- `format=text` one-liner
- `format=md` Slack markdown
- `format=svg` 1200x630 share card
- `format=svg&badge=1` Pulse README badge (compact SVG)
- `GET /v1` lists every endpoint machine-readably
- `GET /v1/dialect` lists query parameters
- `GET /v1/pulse` is the morning OS (weather, kit, air, carbon, planets in sight)

## Demo limits (no Bearer)

Do not learn these from a 429. Production demo per network:

- Burst: 8 calls / 10 seconds (4 if the geo is strict or the User-Agent is empty/tool-like)
- Minute: 12 (4 if strict)
- Hour: 60 (12 if strict)
- Shared demo shed: 80 / minute across all demo callers (HTTP 503). A paid key is not shed with the demo.

A valid Bearer key skips the demo window and uses the key burst/minute caps instead.

## Do not invent

- Do not invent social follower counts
- Do not claim Login with Claude. Anthropic is not an identity provider
- There is no key rotate. Revoke kills the key. Request a replacement from pricing
- Tidalux Ltd is not VAT registered. The price is the price

## Docs

- /docs/style.html
- /docs/life/pulse.html
- /docs/login.html
- /docs/about.html
- /about.html (studio and team)
- /for/agents.html (MCP and agent builders)
- /try.html (live demo, no key)