Skip to content
MCP server

CurrencyFreaks

Live and historical exchange rates and conversion for 1000+ currencies via your API key

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
1.0.1
Listing updated
2 days ago

About CurrencyFreaks

CurrencyFreaks is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • CURRENCYFREAKS_API_KEYYour CurrencyFreaks API key (get one at https://currencyfreaks.com)Required
  • CURRENCYFREAKS_REQUEST_TIMEOUT_MSRequest timeout in milliseconds (default 15000)

What it does

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

Pricing

Freemium

Free plan with 1,000 calls a month; paid plan prices are on the pricing page

Prices change. Check currencyfreaks.com before you buy.

CurrencyFreaks 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 to CurrencyFreaks

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government