{
  "markdown": "# frankfurter-mcp\n\nOfficial [Model Context Protocol](https://modelcontextprotocol.io) server for the\n[Frankfurter](https://frankfurter.dev) exchange-rate API. A thin, stateless proxy\nover Frankfurter's v2 blended multi-source reference rates.\n\n## Tools\n\n- **`convert`** — the primary tool. Convert an amount between two currencies;\n  returns a money object `{ amount, currency }` rounded to the target's minor\n  units. Pass `date` for a historical rate.\n- **`get_rates`** — blended reference rates for the latest day or a single\n  `date`. Optional `base` and `quotes`. The raw-rate companion to `convert`.\n- **`list_currencies`** — supported ISO 4217 codes and names as `{ code: name }`.\n\nFor time series, historical ranges, provider-specific rates, or bulk queries,\nuse the REST API at `https://api.frankfurter.dev/v2` directly.\n\nRates are daily reference rates, not real-time trading rates. Not financial advice.\n\n## Run\n\n```bash\nnpm install\nnpm run build\nnpm start            # listens on :3000, POST /\n```\n\nDocker:\n\n```bash\ndocker build -t frankfurter-mcp . && docker run -p 3000:3000 frankfurter-mcp\ndocker run -p 3000:3000 ghcr.io/lineofflight/frankfurter-mcp:latest\n```\n\nThe prebuilt `ghcr.io/lineofflight/frankfurter-mcp:latest` image is published\non each release; building from source also works.\n\nPoint any MCP client at `http://<host>:3000/` (Streamable HTTP). The hosted\nserver is at `https://mcp.frankfurter.dev/`.\n\n## Configuration\n\n- `PORT` — HTTP port (default `3000`).\n- `FRANKFURTER_API_URL` — upstream API base (default `https://api.frankfurter.dev`).\n  Set this to a self-hosted Frankfurter instance if desired. The value must be a\n  host root: any path prefix in it is discarded (e.g. `https://example.com/api`\n  resolves to `https://example.com/v2/rates`), so a self-hosted instance must be\n  reachable at the host root.\n\n## Development\n\n```bash\nnpm test       # vitest\nnpm run lint   # biome\n```\n\n## License\n\nMIT\n",
  "bytes": 1936,
  "sha": "415bf50484003d810432cda12e0044c23d0cb6319ab73011ce995723c7b69a42",
  "repo_slug": "lineofflight/frankfurter-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_lineofflight_frankfurter_63c92d48/readme"
}