A Model Context Protocol (MCP) server for currency conversion using the Frankfurter API
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"currency-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Currency MCP Server A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that provides currency conversion capabilities using the reliable [Frankfurter API](https://api.frankfurter.app/). ## Features - **Real-time Exchange Rates**: Get current exchange rates for 31+ supported currencies - **Historical Data**: Convert currencies using historical rates from specific dates - **MCP Integration**: Seamlessly integrates with MCP-compatible AI tools and clients - **No API Keys Required**: Free and reliable service with no authentication needed - **Async Support**: Built with modern async Python for optimal performance - **Input Validation**: Robust validation for currency codes, amounts, and dates ## Installation ### From PyPI ```bash pip install currency-mcp ``` ### From Source ```bash git clone https://github.com/vanloc1808/currency-mcp.git cd currency-mcp uv sync ``` ## Usage ### As a Standalone MCP Server ```bash # Run the server directly python currency_mcp_server.py # Or use the installed package currency-mcp ``` ### In AI Tools and Editors #### Claude (Anthropic) 1. **Install the package**: ```bash pip install currency-mcp ``` 2. **Configure Claude** to use the MCP server: - In Claude's settings, add an MCP server configuration - **Name**: Currency Converter - **Command**: `python -m currency_mcp_server` - **Transport**: stdio 3. **Example questions to ask Claude**: - "Convert 500 USD to Japanese Yen" - "What was the exchange rate between EUR and GBP on March 15, 2024?" - "How much is 1000 CAD worth in Australian dollars?" - "Show me all the currencies you can convert between" - "What's the current rate for USD to Swiss Franc?" - "Convert 250 EUR to USD using today's rate" #### Cursor 1. **Install the package**: ```bash pip install currency-mcp ``` 2. **Configure Cursor** to use the MCP server: - Open Cursor settings - Navigate to AI settings - Add a new MCP server with:…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.