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 API Key Quickstart

Remote MCP URL

https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY

Bearer token option

Authorization: Bearer YOUR_API_KEY

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.

Create API key

Add MCP URL

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

Ask for rates

Run prompts for conversion, timeseries, historical rates, and supported currencies.

URL parameter

https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY

Bearer token

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

Open Claude settings and go to Connectors.
Add a custom connector.
Use the remote server URL below.

https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY

Open Apps or connector settings.
Create a custom MCP app or connector.
Use URL auth and select no additional authentication if prompted.

https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY

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

{
  "mcpServers": {
    "currencybeacon": {
      "url": "https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}

Create .vscode/mcp.json in your workspace.

{
  "servers": {
    "currencybeacon": {
      "type": "http",
      "url": "https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}

claude mcp add -t http currencybeacon "https://api.currencybeacon.com/mcp?api_key=YOUR_API_KEY"

Edit ~/.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.

{
  "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.

Need help

Email [email protected] with your client name and error message.