How to Use the ExchangeRate- MCP in Claude Code

Q: How do I add the ExchangeRate- MCP Server to Claude Code?

Run the command claude mcp add --transport http exchangerate -- in your terminal. This adds the server to your /.claude.json configuration file immediately.

Q: How do I check my remaining API requests using Claude Code and ExchangeRate-?

Just ask Claude Code to check your limits. It will run getquota and print your remaining request count directly in your terminal window.

Query real-time exchange rates and historical currency data directly from your terminal using Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ExchangeRate- MCP to Claude Code

Create your Vinkius account to connect ExchangeRate- to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup ExchangeRate- with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Terminal-driven currency checks with Claude Code and MCP

Claude Code calls `get_pair_conversion` to instantly calculate conversions between any two currencies and pipe the output to your terminal. This command calculates conversions without opening a browser or writing custom curl statements. Your agent runs `get_supported_codes` to list all 160+ supported codes when you need to verify a currency code inside a shell script. The clean output is printed directly to stdout, ready for grep or awk.

Headless historical rates ingestion

Automating data pipelines is straightforward when Claude Code uses `get_historical_data` to fetch past rates. The formatted output is saved directly into CSV or JSON files for your cron jobs. To process localized details for a batch of currencies, the agent calls `get_enriched_data`. This metadata is processed and updated in your configuration files before the script exits.

API health and quota monitoring

Claude Code runs `get_quota` to check your remaining requests before initiating automated deployment scripts through this MCP toolset. This safety check keeps your CI/CD pipelines running smoothly. Updating local configuration files is simple when the agent uses `get_latest_rates` to fetch current rates. Your environment variables are updated in one quick step from the terminal.

Setup guide

Set up ExchangeRate- MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see exchangerate-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest ExchangeRate- transactions." It will automatically discover and invoke the available ExchangeRate- tools.

Terminal

claude mcp add --transport http exchangerate-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the ExchangeRate- MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "exchangerate-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ExchangeRate-API. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ExchangeRate- now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ExchangeRate- MCP in Claude Code

Run the command `claude mcp add --transport http exchangerate -- ` in your terminal. This adds the server to your `~/.claude.json` configuration file immediately.

Yes. You can instruct Claude Code to loop through a list of currencies in your terminal, calling `get_pair_conversion` for each one and saving the results to a local file.

Yes. Because this MCP Server runs in the terminal via Claude Code, you can use it in GitHub Actions, Docker containers, or SSH sessions to automate currency updates.

Just ask Claude Code to check your limits. It will run `get_quota` and print your remaining request count directly in your terminal window.

It only transmits public currency codes, target dates, and your API key to check quotas. No database schemas, code files, or customer transaction records are ever sent to the external API.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript