Anirbanbasu Frankfurtermcp

A MCP server for the Frankfurter API for currency exchange rates.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "anirbanbasu-frankfurtermcp": {
      "command": "uvx",
      "args": [
        "frankfurtermcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (6)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Anirbanbasu Frankfurtermcp.

get_supported_currencies

Get a list of currencies supported by the Frankfurter API.

get_latest_exchange_rates

Get latest exchange rates in specific currencies for a given base currency.

convert_currency_latest

Convert an amount from one currency to another using the latest exchange rates.

get_historical_exchange_rates

Get historical exchange rates for a specific date or date range in specific currencies for a given base currency.

convert_currency_specific_date

Convert an amount from one currency to another using the exchange rates for a specific date.

greet

Get a greeting from the FrankfurterMCP server. _This is mostly used for internal testing_.

Documentation Overview

GitHub commits since latest release

Frankfurter MCP

Frankfurter is a useful API for latest currency exchange rates, historical data, or time series published by sources such as the European Central Bank. Should you have to access the Frankfurter API as tools for language model agents exposed over the Model Context Protocol (MCP), Frankfurter MCP is what you need.

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 just to manage project tasks.

Install uv. To install the project with its minimal dependencies in a virtual environment, run the just install in the WD. To install all non-essential dependencies (which are required for developing and testing), run just install-all instead.

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. Note that the default values listed in the table below are not always the same as those in the .env.template file.

The following environment variables can be specified, prefixed with FASTMCP_: HOST, PORT, DEBUG and LOG_LEVEL.

The underlying HTTP client also respects some environment variables, as documented in the HTTPX library. In addition, SSL_CERT_FILE and SSL_CERT_DIR can be configured to use self-signed certificates of hosted API endpoint or intermediate HTTP(S) proxy server(s).

Frankfurter MCP will cache calls to the Frankfurter API to improve performance. The cache happens with two different strategies. For API calls whose responses do not change for certain parameters, e.g., historical rate lookup, a least recently used (LRU) cache is used. For API calls whose responses do change, e.g., latest rate lookup, a time-to-live (TTL) cache is used with a default time-to-live set to 15 minutes. The cache parameters can be adjusted using the environment variables, see below.

Variable	[Default value] and description
`LOG_LEVEL`	[INFO] The level for logging. Changing this level also affects the log output of other dependent libraries that may use the same environment variable. See valid values at Python logging documentation.
`HTTPX_TIMEOUT`	[5.0] The time for the underlying HTTP client to wait, in seconds, for a response from the Frankfurter API. The acceptable range of values is between 5.0 and 60.0.
`HTTPX_VERIFY_SSL`	[True] This variable can be set to False to turn off SSL certificate verification, if, for instance, you are using a proxy server with a self-signed certificate. However, setting this to False is advised against: instead, use the `SSL_CERT_FILE` and `SSL_CERT_DIR` variables to properly configure self-signed certificates.
`FAST_MCP_HOST`	[localhost] This variable specifies which host the MCP server must bind to unless the server transport (see below) is set to `stdio`. Note that running the server to bind to any IP by specifying `0.0.0.0` poses a security threat. Such a setting should only be used in demo environments.
`FAST_MCP_PORT`	[8000] This variable specifies which port the MCP server must listen on unless the server transport (see below) is set to `stdio`.
`CORS_MIDDLEWARE_ALLOW_ORIGINS`	["localhost", "127.0.0.1"] This variable specifies Cross-Origin Resource Sharing (CORS) allowed origins for the MCP server unless the server transport (see below) is set to `stdio`. You must set it to "*" explicitly (and you will get a warning by doing so) if you want to test this server over an HTTP transport using the MCP inspector described below.
`MCP_SERVER_TRANSPORT`	[stdio] The acceptable options are `stdio`, `sse` or `streamable-http`. However, in the `.env.template`, the default value is set to `stdio`.
`MCP_SERVER_INCLUDE_METADATA_IN_RESPONSE`	[True] This specifies if additional metadata will be included with the MCP response from each tool call. The additional metadata, for example, will include the API URL of the Frankfurter server, amongst others, that is used to obtain the responses.
`FRANKFURTER_API_URL`	[https://api.frankfurter.dev/v1] If you are self-hosting the Frankfurter API, you should change this to the API endpoint address of your deployment.
`LRU_CACHE_MAX_SIZE`	[1024] The maximum size of the least recently used (LRU) cache for API calls. The acceptable range of values is between 128 and 65536.
`TTL_CACHE_MAX_SIZE`	[256] The maximum size of the time-to-live (TTL) cache for API calls. The acceptable range of values is between 64 and 16384.
`TTL_CACHE_TTL_SECONDS`	[900] The time limit, in seconds, of the time-to-live (TTL) cache for API calls. The acceptable range of values is between 60 and 3600.
`UVICORN_LIMIT_CONCURRENCY`	[100] The maximum number of concurrent connections the server will accept. This helps prevent resource exhaustion from too many simultaneous connections. Only applies when using HTTP transports (`sse` or `streamable-http`). The acceptable range of values is between 10 and 10000.
`UVICORN_TIMEOUT_KEEP_ALIVE`	[60] The timeout in seconds for keeping idle connections alive. Idle connections will be closed after this period to free up resources. Only applies when using HTTP transports (`sse` or `streamable-http`). The acceptable range of values is between 60 and 300.
`UVICORN_TIMEOUT_GRACEFUL_SHUTDOWN`	[5] The timeout in seconds for graceful shutdown. The server will wait this long for active connections to complete before forcefully shutting down. Only applies when using HTTP transports (`sse` or `streamable-http`). The acceptable range of values is between 5 and 60.
`RATE_LIMIT_MAX_REQUESTS_PER_SECOND`	[10.0] The maximum number of requests allowed per second using a token bucket algorithm. This implements rate limiting to prevent API abuse and ensure fair resource allocation. The acceptable range of values is between 1.0 and 10000.0.
`RATE_LIMIT_BURST_CAPACITY`	[20] The burst capacity for the rate limiter, allowing short bursts of requests above the per-second limit. This provides flexibility for legitimate usage patterns while still protecting against sustained high request rates. The acceptable range of values is between 2x and 5x the `RATE_LIMIT_MAX_REQUESTS_PER_SECOND` value.
`REQUEST_SIZE_LIMIT_BYTES`	[102400] The maximum size in bytes for HTTP request bodies (default 100KB). Requests exceeding this limit will be rejected with a 413 status code. This prevents memory exhaustion attacks from large payloads. Only applies when using HTTP transports (`sse` or `streamable-http`). The acceptable range of values is between 10240 (10KB) and 524288 (512KB).
`DOCKER_TMPFS_SIZE_MB`	[100] The size in megabytes for the temporary filesystem (`/tmp`) when running in Docker with read-only root filesystem. This temporary storage is used for runtime file operations. Increase this value if the application requires more temporary storage for caching or processing large datasets. Only relevant when deploying with Docker Compose.

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.

If you want to run Frankfurter MCP with stdio transport and the default parameters, execute the commands below without using the .env.template file.

Server with `uv`

Optional: Copy the .env.template file to a .env file in the WD, to modify the aforementioned environment variables, if you want to use anything other than the default settings. Or, on your shell, you can export the environment variables that you wish to modify.

Run the following in the WD to start the MCP server.

bash

uv run frankfurtermcp

Server with `pip` from PyPI package

Add this package from PyPI using pip in a virtual environment (possibly managed by uv, pyenv or conda) and then start the server by running the following.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

Package downloads in the last 30 days.

Last commit

2mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Anirbanbasu Frankfurtermcp

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "anirbanbasu-frankfurtermcp": { "command": "uvx", "args": ["frankfurtermcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Anirbanbasu Frankfurtermcp AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/anirbanbasu-frankfurtermcp?style=directory)](https://allmcps.com/mcp/anirbanbasu-frankfurtermcp)

HTML Embed

<a href="https://allmcps.com/mcp/anirbanbasu-frankfurtermcp"><img src="https://allmcps.com/api/badge/anirbanbasu-frankfurtermcp?style=directory" alt="Anirbanbasu Frankfurtermcp on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

4/4 checks healthy over the last 46d

56Quality signal: Good · 56/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools24/30

Adoption & activity8/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · frankfurtermcp (PyPI)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Anirbanbasu Frankfurtermcp →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Anirbanbasu Frankfurtermcp

A MCP server for the Frankfurter API for currency exchange rates.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "anirbanbasu-frankfurtermcp": {
      "command": "uvx",
      "args": [
        "frankfurtermcp"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (6)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Anirbanbasu Frankfurtermcp.

get_supported_currencies

Get a list of currencies supported by the Frankfurter API.

get_latest_exchange_rates

Get latest exchange rates in specific currencies for a given base currency.

convert_currency_latest

Convert an amount from one currency to another using the latest exchange rates.

get_historical_exchange_rates

Get historical exchange rates for a specific date or date range in specific currencies for a given base currency.

convert_currency_specific_date

Convert an amount from one currency to another using the exchange rates for a specific date.

greet

Get a greeting from the FrankfurterMCP server. _This is mostly used for internal testing_.

Documentation Overview

GitHub commits since latest release

Frankfurter MCP

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 just to manage project tasks.

Environment variables

The following environment variables can be specified, prefixed with FASTMCP_: HOST, PORT, DEBUG and LOG_LEVEL.

Variable	[Default value] and description
`LOG_LEVEL`	[INFO] The level for logging. Changing this level also affects the log output of other dependent libraries that may use the same environment variable. See valid values at Python logging documentation.
`HTTPX_TIMEOUT`	[5.0] The time for the underlying HTTP client to wait, in seconds, for a response from the Frankfurter API. The acceptable range of values is between 5.0 and 60.0.
`HTTPX_VERIFY_SSL`	[True] This variable can be set to False to turn off SSL certificate verification, if, for instance, you are using a proxy server with a self-signed certificate. However, setting this to False is advised against: instead, use the `SSL_CERT_FILE` and `SSL_CERT_DIR` variables to properly configure self-signed certificates.
`FAST_MCP_HOST`	[localhost] This variable specifies which host the MCP server must bind to unless the server transport (see below) is set to `stdio`. Note that running the server to bind to any IP by specifying `0.0.0.0` poses a security threat. Such a setting should only be used in demo environments.
`FAST_MCP_PORT`	[8000] This variable specifies which port the MCP server must listen on unless the server transport (see below) is set to `stdio`.
`CORS_MIDDLEWARE_ALLOW_ORIGINS`	["localhost", "127.0.0.1"] This variable specifies Cross-Origin Resource Sharing (CORS) allowed origins for the MCP server unless the server transport (see below) is set to `stdio`. You must set it to "*" explicitly (and you will get a warning by doing so) if you want to test this server over an HTTP transport using the MCP inspector described below.
`MCP_SERVER_TRANSPORT`	[stdio] The acceptable options are `stdio`, `sse` or `streamable-http`. However, in the `.env.template`, the default value is set to `stdio`.
`MCP_SERVER_INCLUDE_METADATA_IN_RESPONSE`	[True] This specifies if additional metadata will be included with the MCP response from each tool call. The additional metadata, for example, will include the API URL of the Frankfurter server, amongst others, that is used to obtain the responses.
`FRANKFURTER_API_URL`	[https://api.frankfurter.dev/v1] If you are self-hosting the Frankfurter API, you should change this to the API endpoint address of your deployment.
`LRU_CACHE_MAX_SIZE`	[1024] The maximum size of the least recently used (LRU) cache for API calls. The acceptable range of values is between 128 and 65536.
`TTL_CACHE_MAX_SIZE`	[256] The maximum size of the time-to-live (TTL) cache for API calls. The acceptable range of values is between 64 and 16384.
`TTL_CACHE_TTL_SECONDS`	[900] The time limit, in seconds, of the time-to-live (TTL) cache for API calls. The acceptable range of values is between 60 and 3600.
`UVICORN_LIMIT_CONCURRENCY`	[100] The maximum number of concurrent connections the server will accept. This helps prevent resource exhaustion from too many simultaneous connections. Only applies when using HTTP transports (`sse` or `streamable-http`). The acceptable range of values is between 10 and 10000.
`UVICORN_TIMEOUT_KEEP_ALIVE`	[60] The timeout in seconds for keeping idle connections alive. Idle connections will be closed after this period to free up resources. Only applies when using HTTP transports (`sse` or `streamable-http`). The acceptable range of values is between 60 and 300.
`UVICORN_TIMEOUT_GRACEFUL_SHUTDOWN`	[5] The timeout in seconds for graceful shutdown. The server will wait this long for active connections to complete before forcefully shutting down. Only applies when using HTTP transports (`sse` or `streamable-http`). The acceptable range of values is between 5 and 60.
`RATE_LIMIT_MAX_REQUESTS_PER_SECOND`	[10.0] The maximum number of requests allowed per second using a token bucket algorithm. This implements rate limiting to prevent API abuse and ensure fair resource allocation. The acceptable range of values is between 1.0 and 10000.0.
`RATE_LIMIT_BURST_CAPACITY`	[20] The burst capacity for the rate limiter, allowing short bursts of requests above the per-second limit. This provides flexibility for legitimate usage patterns while still protecting against sustained high request rates. The acceptable range of values is between 2x and 5x the `RATE_LIMIT_MAX_REQUESTS_PER_SECOND` value.
`REQUEST_SIZE_LIMIT_BYTES`	[102400] The maximum size in bytes for HTTP request bodies (default 100KB). Requests exceeding this limit will be rejected with a 413 status code. This prevents memory exhaustion attacks from large payloads. Only applies when using HTTP transports (`sse` or `streamable-http`). The acceptable range of values is between 10240 (10KB) and 524288 (512KB).
`DOCKER_TMPFS_SIZE_MB`	[100] The size in megabytes for the temporary filesystem (`/tmp`) when running in Docker with read-only root filesystem. This temporary storage is used for runtime file operations. Increase this value if the application requires more temporary storage for caching or processing large datasets. Only relevant when deploying with Docker Compose.

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).

If you want to run Frankfurter MCP with stdio transport and the default parameters, execute the commands below without using the .env.template file.

Server with `uv`

Run the following in the WD to start the MCP server.

bash

uv run frankfurtermcp

Server with `pip` from PyPI package

Add this package from PyPI using pip in a virtual environment (possibly managed by uv, pyenv or conda) and then start the server by running the following.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

npm downloads

Package downloads in the last 30 days.

Last commit

2mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Anirbanbasu Frankfurtermcp

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "anirbanbasu-frankfurtermcp": { "command": "uvx", "args": ["frankfurtermcp"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/anirbanbasu-frankfurtermcp?style=directory)](https://allmcps.com/mcp/anirbanbasu-frankfurtermcp)

HTML Embed

<a href="https://allmcps.com/mcp/anirbanbasu-frankfurtermcp"><img src="https://allmcps.com/api/badge/anirbanbasu-frankfurtermcp?style=directory" alt="Anirbanbasu Frankfurtermcp on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

4/4 checks healthy over the last 46d

56Quality signal: Good · 56/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools24/30

Adoption & activity8/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev · frankfurtermcp (PyPI)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Anirbanbasu Frankfurtermcp

Quick Install

Client Config & Setup

Documentation Overview

Frankfurter MCP

Installation

Environment variables

Usage

Server

Server with uv

Server with pip from PyPI package

Related MCP Servers

Adoption & maintenance

Reviews

Frequently Asked Questions about Anirbanbasu Frankfurtermcp

AllMCPs Directory Badge

Technical Specs & Signals

Supply-chain signal

Feature Your MCP Server

Own this project?

Share & Embed

Explore more

Anirbanbasu Frankfurtermcp

Quick Install

Client Config & Setup

Documentation Overview

Frankfurter MCP

Installation

Environment variables

Usage

Server

Server with uv

Server with pip from PyPI package

Related MCP Servers

Adoption & maintenance

Reviews

Frequently Asked Questions about Anirbanbasu Frankfurtermcp

AllMCPs Directory Badge

Technical Specs & Signals

Supply-chain signal

Feature Your MCP Server

Own this project?

Share & Embed

Explore more

Server with `uv`

Server with `pip` from PyPI package

Server with `uv`

Server with `pip` from PyPI package