How to Use the ExchangeRate-API MCP in Vercel AI SDK

Q: Does ExchangeRate-API support historical lookups in Vercel AI SDK?

Absolutely. Use gethistoricalrates to pull past data points. Your agent can then compare these to current rates for your users.

Stream live currency data directly into your Vercel AI SDK interface without the usual loading screen delays.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ExchangeRate-API MCP to Vercel AI SDK

Create your Vinkius account to connect ExchangeRate-API to Vercel AI SDK 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-API with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-time rate streaming for Vercel AI SDK

Feed live market data straight into your UI components using `get_latest_rates`. You don't wait for a background process to finish; the data pipes directly into your frontend stream. Your users see the conversion values update as the AI agent fetches them. It makes the interaction feel immediate rather than detached.

Dynamic currency conversion

Handle complex math inside your app with `convert_currency_pair`. Pass the user's input through your agent and get the exact math returned in your response. It removes the need for custom backend logic to calculate base rates. You get the result, and your component renders it instantly.

Enriched data for financial dashboards

Access metadata like flags and full names using `get_enriched_currency_data`. This gives your interface context beyond just a raw number. It's useful for building clean UI elements that show the user exactly which currency they are looking at. Your AI client handles the heavy lifting.

Setup guide

Set up ExchangeRate-API MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all ExchangeRate-API tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent ExchangeRate-API transactions",
});

console.log(text);
await mcpClient.close();

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-API 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-API MCP in Vercel AI SDK

Install the MCP package via npm and initialize the client with your endpoint. Pass the tools directly into your `generateText` configuration. It's that simple.

Yes. The transport layer is designed to run on the edge. You won't hit performance bottlenecks when calling the server.

Absolutely. Use `get_historical_rates` to pull past data points. Your agent can then compare these to current rates for your users.

We keep your API key on the server side. Only the necessary requests are sent to the ExchangeRate-API endpoint.

The SDK catches failures at the tool call level. You can write a fallback block to notify the user if the rate fetch fails.

Use it with your favorite AI tools

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