# CurrencyFreaks

> CurrencyFreaks is a freemium MCP server for finance and payments. Live and historical exchange rates and conversion for 1000+ currencies via your API key. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://currencyfreaks.com
- **Repository:** https://github.com/currencyfreaks/currencyfreaks-mcp
- **MCP Registry name:** io.github.CurrencyFreaks/currencyfreaks-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

This is the official MCP wrapper for the CurrencyFreaks exchange-rate API, which the website says covers 166 fiat currencies, 878 cryptocurrencies and 4 precious metals. The README says it exposes seven tools so an assistant can answer rate and conversion questions in plain English, and it needs your own API key in CURRENCYFREAKS_API_KEY.

What you can get depends on the plan behind the key. The free Developer plan has 1,000 calls a month with daily updates and USD as the base; Starter adds hourly updates, historical rates, all base currencies and conversion; Growth updates every 10 minutes; Professional and Enterprise update every 60 seconds and add time series and fluctuation endpoints. Historical data goes back to 28 November 1984 on paid plans. A README section lists plan requirements per tool.

It runs over stdio with Node.js 18 or later and has setup notes for Claude Desktop, Claude Code, Cursor, Windsurf, VS Code and Cline, with a one-click Cursor install.

## Features

- **Latest rates:** Returns current mid-market rates across supported currencies.
- **Currency conversion:** Converts an amount between fiat, crypto and metals.
- **Historical lookups:** Fetches past rates by date on paid plans.
- **Plan-aware tools:** Some tools require a higher plan, as documented in the README.
- **Configurable timeout:** CURRENCYFREAKS_REQUEST_TIMEOUT_MS adjusts the request timeout, default 15000.

## Good for

- Ask for today's EUR to USD rate in chat
- Convert a price into a customer's local currency
- Pull historical rates for an invoice date
- Compare a crypto price against several fiat currencies
- Look up precious metal rates

## Install

### Claude Code (Terminal)

```sh
claude mcp add currencyfreaks-mcp --env CURRENCYFREAKS_API_KEY='<CURRENCYFREAKS_API_KEY>' -- npx -y @currencyfreaks/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "currencyfreaks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@currencyfreaks/mcp"
      ],
      "env": {
        "CURRENCYFREAKS_API_KEY": "<CURRENCYFREAKS_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "currencyfreaks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@currencyfreaks/mcp"
      ],
      "env": {
        "CURRENCYFREAKS_API_KEY": "<CURRENCYFREAKS_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "currencyfreaks-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@currencyfreaks/mcp"
      ],
      "env": {
        "CURRENCYFREAKS_API_KEY": "<CURRENCYFREAKS_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "currencyfreaks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@currencyfreaks/mcp"
      ],
      "env": {
        "CURRENCYFREAKS_API_KEY": "<CURRENCYFREAKS_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "currencyfreaks-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@currencyfreaks/mcp"
      ],
      "env": {
        "CURRENCYFREAKS_API_KEY": "<CURRENCYFREAKS_API_KEY>"
      }
    }
  }
}
```

## FAQ

### Do I need an API key?

Yes, a CurrencyFreaks key is required; a free one has 1,000 requests a month with no card.

### How often do rates update?

Daily on Developer, hourly on Starter, every 10 minutes on Growth and every 60 seconds on Professional and Enterprise.

### Can I change the base currency?

On paid plans; the free plan uses USD.

### Which Node version is needed?

Node.js 18 or later.

### Is CurrencyFreaks free?

CurrencyFreaks has a free plan, with paid plans for more usage or features.

### How do I add CurrencyFreaks to Claude Code?

Run this command in your terminal: claude mcp add currencyfreaks-mcp --env CURRENCYFREAKS_API_KEY='<CURRENCYFREAKS_API_KEY>' -- npx -y @currencyfreaks/mcp

### What are the best alternatives to CurrencyFreaks?

The closest alternatives to CurrencyFreaks are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/currencyfreaks
