---
name: frankfurter-exchange-rates
description: Look up current, historical, and converted foreign-exchange rates via the Frankfurter API (ECB data, no auth). Use when the user asks about currency conversion or exchange rates.
---

# Frankfurter Exchange Rates — Agent Skill (illustrative sample)

> Sample Agent Skill produced to demonstrate an agent-ready package on the public Frankfurter API.
> Not affiliated with Frankfurter. Pairs with the `frankfurter` MCP server in this package.

## When to use this
Use these tools whenever the user wants:
- the current exchange rate between two currencies,
- to convert a specific amount between currencies,
- a historical rate on a given date, or
- the list of supported currencies.

## Tools
- `get_latest_rates(base, symbols)` — most recent rates for a base currency.
- `convert(amount, from_currency, to_currency)` — convert an amount at the latest rate.
- `get_historical_rates(date, base, symbols)` — rates on a specific date (`YYYY-MM-DD`).
- `list_currencies()` — supported ISO 4217 codes and names.

## How to use it well
- Prefer `convert` when the user gives an amount ("how much is $250 in euros?").
- Prefer `get_latest_rates` when they just want a rate ("USD to GBP right now?").
- Currency codes are ISO 4217 (`USD`, `EUR`, `GBP`, `JPY`, …). If the user names a country or symbol, map it to the code first; if unsure, call `list_currencies()`.
- Rates update on ECB **working days**. For weekends/holidays, a historical lookup returns the most recent prior working day — say so if it matters.
- These tools are **read-only**; there is nothing to write or undo.

## Examples
- "Convert 250 USD to EUR" → `convert(250, "USD", "EUR")`.
- "What was EUR→JPY on 2024-03-15?" → `get_historical_rates("2024-03-15", "EUR", "JPY")`.
- "What currencies do you support?" → `list_currencies()`.