Model Context Protocol

Currency data for AI agents

Connect Claude, ChatGPT, Cursor, VS Code, Codex, and other MCP clients to CurrencyBeacon rates. Use the same API key, quota, and exchange-rate data as the REST API.

Get your API key Quickstart
Remote MCP URL 
https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY

Same key as the REST API. Each successful tools/call counts as one request against your quota.

Quickstart

Connect in three steps

Use URL-parameter auth when your MCP client does not support custom headers. Use bearer-token auth when it does.

01

Create API key

Sign in and copy your CurrencyBeacon key from the account dashboard.

02

Add MCP URL

Paste the remote server URL into your LLM client or agent builder.

03

Ask for rates

Run prompts for conversion, time-series, historical rates, and supported currencies.

URL parameter

Works with every client, including those without header support.

Server URL
https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY
Bearer token

Keeps the key out of the URL for clients that expose headers.

URL + header
URL: https://api.currencybeacon.com/mcp
Header: Authorization: Bearer YOUR_API_KEY
Setup Instructions by Use Case

Pick the workflow you are building

Power a chatbot

Give support, finance, and ops assistants access to live conversions and supported currency metadata.

  • get_latest_rates
  • convert_currency

Build finance agents

Analyze historical rates, compare currency movement, and create reports from timeseries data.

  • get_time_series
  • get_historical_rates

Code with live FX

Let coding assistants fetch live exchange-rate data while building dashboards or billing flows.

  • Cursor
  • VS Code
  • Codex

Monitor usage

Let agents check remaining quota before running larger workflows or repeated timeseries calls.

  • get_account_usage
Client Setup

Copy the config for your tool

The query-parameter URL is the fastest path. Header-based auth is also supported for clients that expose headers.

Claude
  1. Open Claude settings and go to Connectors.
  2. Add a custom connector.
  3. Use the remote server URL below.
Remote server URL
https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY
ChatGPT
  1. Open Apps or connector settings.
  2. Create a custom MCP app or connector.
  3. Use URL auth and select no additional authentication if prompted.
Remote server URL
https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY
Cursor

Create or edit ~/.cursor/mcp.json.

~/.cursor/mcp.json
{
  "mcpServers": {
    "currencybeacon": {
      "url": "https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}
VS Code

Create .vscode/mcp.json in your workspace.

.vscode/mcp.json
{
  "servers": {
    "currencybeacon": {
      "type": "http",
      "url": "https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}
Claude Code
Terminal
claude mcp add -t http currencybeacon "https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY"
Codex

Edit ~/.codex/config.toml.

~/.codex/config.toml
[mcp_servers.currencybeacon]
url = "https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY"

Header-based configuration

Use this when your client supports custom headers.

mcp.json
{
  "mcpServers": {
    "currencybeacon": {
      "url": "https://api.currencybeacon.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Examples

Prompts to try after setup

Live conversion

Convert 1,250 USD to EUR using CurrencyBeacon, then show the raw rate and converted amount.

Historical audit

Get USD to GBP rates for 2024-03-15 and explain how to use the result for invoice reconciliation.

Trend report

Fetch USD to JPY daily rates for Q1 2025 and summarize the strongest and weakest periods.

App build

Use CurrencyBeacon MCP to design a currency conversion widget with USD, EUR, GBP, CAD, and GHS.

Tools Reference

Available tools

Each successful tools/call counts as one request against your CurrencyBeacon API usage.

get_latest_rates

Inputs: base, symbols. Returns latest rates for the requested base.

convert_currency

Inputs: from, to, amount, optional date.

get_historical_rates

Inputs: date, base, symbols. Returns rates for one date.

get_time_series

Inputs: start_date, end_date, base, symbols.

list_currencies

Returns supported currency names, codes, symbols, precision, and formatting metadata.

get_account_usage

Returns current plan, used calls, limit, and remaining API requests.

Troubleshooting

Checks that solve most setup issues

No tools appear

Confirm the server URL includes your API key or the Authorization header is present.

Quota errors

Run get_account_usage or check your dashboard. MCP and REST usage share the same quota.

Wrong currency code

Run list_currencies and use ISO-style three-letter currency codes.