# Frankfurter — Agent-Ready Delivery (illustrative example)

> **Illustrative example, not client work.** Built on the public Frankfurter exchange-rates API to
> show what an Agent-Ready Audit delivery looks like. Not affiliated with Frankfurter. 2026-08-16.

## Before → After

| Layer | Before (as a public utility) | After (this package) |
|---|---|---|
| **llms.txt** | ✗ none | ✓ [`llms.txt`](./llms.txt) — product + API map for agents |
| **Discoverable API** | ✓ clean REST, documented | ✓ (unchanged — good foundation) |
| **MCP server** | ✗ none | ✓ 4 tools ([`frankfurter_mcp.py`](./mcp-server/frankfurter_mcp.py)) |
| **Agent Skill** | ✗ none | ✓ [`SKILL.md`](./skill/SKILL.md) — when/how, with examples |
| **Registry / discoverability** | ✗ not listed for agents | — (in a real delivery: submitted to MCP directories; not done in this sample) |

**Illustrative readiness score:** ~30/100 ("half-open" — good API, no agent layer) → **agent-ready**.

## What was delivered

1. **`llms.txt`** — a curated map so agents understand the API and its endpoints without crawling raw docs.
2. **MCP server** (`frankfurter`) exposing 4 agent tools:
   - `get_latest_rates`, `convert`, `get_historical_rates`, `list_currencies`.
   - Read-only; no auth needed for this API (a real SaaS delivery includes an API-key/OAuth bridge).
3. **Agent Skill** — tells the agent *when* to reach for these tools and *how* to use them well (ISO codes, working-day caveat, amount-vs-rate).
4. *(In a real delivery)* registry listings + a maintenance plan.

## Live demo (what we'd show)

An agent (e.g. Claude) with this MCP server connected can answer "convert 250 USD to EUR" or
"what was EUR→JPY on 2024-03-15?" by calling the tools directly — no custom integration by the user.

## For a real customer

- We select the 8–15 highest-value endpoints (not all), add an auth bridge, guard any write actions,
  deploy to your infra or ours, and hand back this same report with a before/after score.
- Optional maintenance keeps the MCP in sync as your API changes, plus a monthly agent-traffic report.