FrankfurterMCP
Created 5 months ago
Frankfurter MCP is an API for currency exchange rates and historical data.
What is FrankfurterMCP?
MCP server acting as an interface to the [Frankfurter API](https://frankfurter.dev/) for currency exchange data.
Documentation
Installation
If your objective is to use the tools available on this MCP server, please refer to the usage > client sub-section below.
The directory where you clone this repository will be referred to as the working directory or WD hereinafter. Install uv. To install the project with its minimal dependencies in a virtual environment, run the following in the WD.
uv sync --no-dev
Environment variables
Following is a list of environment variables that can be used to configure the application. A template of environment variables is provided in the file .env.template. The following environment variables can be specified, prefixed with FASTMCP_:
HOSTPORTDEBUGLOG_LEVEL
See global configuration options for FastMCP. Note that on_duplicate_ prefixed options specified as environment variables will be ignored. The underlying HTTP client also respects some environment variables, as documented in the HTTPX library.
Usage
The following sub-sections illustrate how to run the Frankfurter MCP as a server and how to access it from MCP clients.
Server
While running the server, you have the choice to use stdio transport or HTTP options (sse or the newer streamable-http). Using default settings and MCP_SERVER_TRANSPORT set to sse or streamable-http, the MCP endpoint will be available over HTTP at http://localhost:8000/sse for the Server Sent Events (SSE) transport, or http://localhost:8000/mcp for the streamable HTTP transport.
Client access
This sub-section explains ways for a client to connect and test the FrankfurterMCP server. A command-line interface (CLI) is also provided for testing, which is explained in a later sub-section.
Server Config
{
"mcpServers": {
"frankfurtermcp-server": {
"command": "npx",
"args": [
"frankfurtermcp"
]
}
}
}