Currencyapi MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Currencyapi MCP or direct API to fetch live rates, convert currencies, look up historical rates, and retrieve currency metadata through natural language.

Currencyapi logoCurrencyapi
Api Key

Currencyapi is an exchange-rate service for current, historical, and official currency data. It also provides currency and country metadata for accurate financial workflows.

15 Tools

Try Currencyapi now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Currencyapi
Try asking
TOOLS

Supported Tools

Every Currencyapi action and event your agent gets out of the box.

Compare Official Rates

Compare one currency pair across selected or all available central-bank sources for a requested date, or across their newest publications.

Convert Amounts

Convert one amount or up to 100 amounts from a base currency into selected currencies, optionally using historical rates, retail rounding, and locale formatting.

Get Account Status

Return the connected account identifier, monthly quota, and plan details when present, without consuming quota.

Get Average Rates

Return average, minimum, and maximum exchange rates grouped by month, quarter, year, or the total requested date span.

Get Exchange Rates

Return latest rates when no date is supplied, or end-of-day rates for one historical date or up to 31 historical dates.

Get Official Rate Range

Return a central bank's official publications across a date range as structured JSON.

Get Official Rates

Return a central bank's latest or dated official publication, optionally compared with market rates.

Get OHLC Rates

Return hourly or daily open, high, low, and close candles for one to 10 currencies.

Get Pair Rate

Return one currency pair's latest rate at the account plan's update interval, a past daily close, or an intraday historical rate, together with its inverse.

Get Rate Fluctuation

Return start, end, change, percentage change, high, low, and average rates between two UTC dates.

Get Rate Matrix

Return latest or daily historical cross-rates among 2 to 25 currencies.

Get Rate Range

Return market exchange rates over a bounded datetime range.

List Countries

List countries with currency, language, timezone, calling-code, and ISO metadata.

List Currencies

List supported fiat currencies, metals, and cryptocurrencies with symbols, precision, and country metadata.

List Official Sources

List central banks and publication metadata, optionally filtered by currency or region.

SETUP GUIDE

Connect Currencyapi MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["currencyapi"],
  mcp: true,
});
Create a session scoped to Currencyapi and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Get the current USD to EUR exchange rate.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Currencyapi request
SETUP GUIDE

Connect Currencyapi API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["currencyapi"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Currencyapi
3

Run Currencyapi tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Get the current USD to EUR exchange rate." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Currencyapi tool calls through the session, and print the final answer

Why Use Composio?

AI Native Currencyapi Integration

  • Supports both Currencyapi MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable exchange-rate and currency-data tool execution
  • Rich coverage for reading current, historical, and official Currencyapi data

Managed Auth

  • Connect your own Currencyapi API key without hard-coding it into agent prompts or application code
  • Central place to securely store, scope, and revoke Currencyapi access
  • Per user and per environment credentials for safer development and production deployments

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Clear schemas help agents request exchange rates, currency conversions, and metadata correctly
  • Comprehensive execution logs show what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC helps control which agents and users can access Currencyapi
  • Scoped, least privilege access to Currencyapi resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Currencyapi.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Currencyapi tool your agent needs.Free to start.

Start building