CurrencyCore
Live FX rates, conversion, IMF PPP, and historical currency analytics.
Hosted MCP Server
npx add-mcp 'https://mcp.currency-core.com/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
What is CurrencyCore?
CurrencyCore is a currency data platform and API for developers and AI agents. It provides reference exchange rates for 160 fiat currencies, historical data from 1949 for GBP/USD and USD/INR, IMF purchasing-power-parity conversion for 197 countries, seven FX analytics endpoints, five official SDKs, and a hosted MCP server with 14 tools. The free tier includes 1,000 API requests and 100 AI credits per month, with no credit card required.
Last updated November 11, 2026
Category
Currency data API
Base URL
api.currency-core.com/v1
Currencies
160 fiat
History
1949 parity; 1971 daily
PPP
197 countries, IMF
Analytics
7 endpoints
MCP
14 tools, every plan
SDKs
TypeScript, Python, Dart, Kotlin, Swift
Auth
Bearer or x-api-key
Free tier
1,000 requests, 100 AI credits
From API key to first rate
Three steps, one GET request, and a JSON response you can use right away. The same account works across REST, MCP, and the AI endpoint.
1
Create a key
Sign up at app.currency-core.com, create an organization, and generate a live key in the API Keys section. No credit card is required.
Export it
Keep the key in an environment variable so it never lands in source control.
export CURRENCYCORE_KEY="cc_live_your_key"
Convert 100 USD to EUR
Pass from, to, and amount. The response returns the rate and converted result.
curl "https://api.currency-core.com/v1/convert?from=USD&to=EUR&amount=100" \
-H "Authorization: Bearer $CURRENCYCORE_KEY"
Authentication uses a Bearer token. Live keys are scoped to your organization, test keys use the Free rate limit, and only successful 2xx requests count toward the monthly limit. Errors return a JSON object with a code and message.
{
"from": "USD",
"amount": 100,
"date": "2026-11-07",
"results": [
{ "to": "EUR", "result": 89.07, "rate": 0.8907 }
]
}
Shape verified against /v1/convert. Trimmed response from the snapshot published 2026-11-06; the rate date is 2026-11-07. Both change with each request.
Connect Claude & AI agents over MCP
CurrencyCore ships a native Model Context Protocol server, so AI assistants fetch reference rates, convert, and pull PPP using your org's keys, usage, and limits. No glue code, and it's included on every plan.
- Works with Claude, ChatGPT, Cursor, VS Code, and Gemini
- OAuth sign-in, then pick your organization
- Same endpoints, metering, and rate limits as the API
Claude ChatGPT Cursor VS Code Gemini
AI agent → MCP server → Currency API
- Claude: add a custom connector under Settings > Connectors with the URL
https://mcp.currency-core.com/mcp. - Cursor: open Customize > MCP and add the same URL as a remote server.
- VS Code: add the server to
.mcp.jsonusing the same URL.
Ask currency questions in plain English
The natural-language endpoint turns a question into a precise answer backed by reference rates, historical data, and PPP intelligence. A native answer uses one AI credit; BYOK on Growth+ bills one API request per successful tool call instead.
How did EUR perform against USD over the last decade?
From 2016 to 2025, EUR/USD gained +2.1% on an annual-average basis, with 3.60% one-year annualized volatility. The peak annual-average year in the series was 2008, when EUR/USD averaged 1.47256.
Currency data from 1949 to today
Not just today's rates. A complete, structured record of currency history, analysis, and purchasing power that no basic rates API provides.
1949
Annual parity from (GBP/USD, USD/INR)
160
Fiat currencies covered
PPP
Purchasing power parity coverage
AI
AI-native analytics built in
Historical rates PPP analysis Trend analysis Volatility analytics Correlation metrics Currency rankings Drawdown analytics
Current rates are central-bank reference rates aggregated via Frankfurter, with ECB as the primary EUR source. The website historical series comes from the Federal Reserve H.10 release via FRED, with documented pre-float parities for GBP and INR. The API history pipeline uses the Frankfurter-seeded history store. Coverage is 40 published pairs: GBP/USD and USD/INR from 1949, major USD pairs from 1971, and EUR pairs from 1999. Annual series are checked against ECB reference rates; across 48 pair-year comparisons the worst difference was 0.10% and the mean absolute difference was 0.036%. The website PPP calculator covers 113 countries across 46 currencies; the API exposes IMF PPP factors for 197 countries. Read the methodology for the full validation rules and limits.
Built for developers, analysts, and AI agents
One dataset, three access modes, and product pages that go deep on each job. Start with the surface that matches how you work.
Developers
Ship a conversion, a rates snapshot, or a full history series from one authenticated REST API. The currency API covers reference rates, while the historical exchange rate API returns dated history back to 1949 for GBP/USD and USD/INR.
Analysts
Measure volatility, correlation, drawdown, rankings, and safe-haven behaviour without stitching three vendors together. The currency analytics API returns the metrics, and currency history gives you the annual series behind them.
AI agents
Connect Claude, Cursor, VS Code, or Gemini to the native MCP server. Agents call the same endpoints under your organization's usage and limits, with no glue code.
All three paths share one dataset and one organization, so an analyst can reproduce the number an agent reported and a developer can trace it to the same historical series. REST and MCP draw on the same request quota; AI has its own credit pool. Prefer natural language? The AI endpoint answers currency questions in plain English, and every result is grounded in the same rate data.
From solo developer to enterprise
Collaborate as a team, then scale with the security and governance larger organizations require.
Team workspaces
- Shared API access across the organization
- Invite members and collaborate
- Organization management
- Role-based access: owner, admin, member
Enterprise ready
- OIDC Single Sign-On (SSO)
- Audit logs
- Unlimited seats
- Organization management
- Priority support
Secure by default
Enterprise-grade security and governance, on the same global edge network that serves every request.
DDoS protection
Always-on, unmetered DDoS mitigation across Cloudflare's global edge sits in front of every request.
OIDC Single Sign-On
Connect Okta, Microsoft Entra ID, Google Workspace, and other OIDC providers, with domain verification and optional Require-SSO.
Audit logs
A durable, exportable trail of every API key, billing, team, and security change in your organization.
Role-based access
Owner, admin, and member roles control who can manage API keys, billing, and members.
Hashed API keys
Keys are hashed at rest, scoped to your organization, split into live and test, and revocation clears within 5 minutes.
Encrypted & protected
Every request is served over HTTPS, with brute-force protection on sign-in. Payments run through a Merchant of Record, so no card data is stored.
More than a currency API
Every row maps to a capability CurrencyCore ships today. For named, sourced comparisons, see Fixer, ExchangeRate-API, and CurrencyAPI.
| Feature | CurrencyCore |
|---|---|
| Exchange rates | |
| Historical data | |
| MCP server | |
| AI queries | |
| Team workspaces | |
| OIDC SSO | |
| Audit logs | |
| Commercial use on Free |
Competitor plans change. Each link opens a comparison with the vendor's current published limits, so you can verify the claims before you budget. Compare CurrencyCore plans.
Named comparisons are most useful when a specific vendor is already in your stack. If you are replacing a rates-only feed, the migration notes on each page show the request shape and the fields that change. If you are adding analytics for the first time, start with the analytics API and the Growth plan.
Start free. Scale with intelligence.
Scale as you grow. MCP access is included on every plan. Billing via Dodo Payments with full tax compliance. See the full comparison →
Free
Free
- 1,000 requests / month
- 60 req/min rate limit
- 100 AI credits / month
- 3 members
- MCP access & PPP adjustment
- Last 30 days of historical FX data
- Community support
Starter
$9 /mo
- 50,000 requests / month
- 120 req/min rate limit
- $0.10 / 1,000 over-limit requests
- 1,000 AI credits / month
- 10 members
- MCP access & PPP adjustment
- Full historical FX data
- Email support
Growth Plus
$79 /mo
- 2,000,000 requests / month
- 3,000 req/min rate limit
- $0.05 / 1,000 over-limit requests
- 20,000 AI credits / month
- Unlimited members
- MCP access & PPP adjustment
- Full historical FX data
- Analytics suite
- Bring your own AI keys (BYOK)
- Priority support
Business
$199 /mo
- 10,000,000 requests / month
- 6,000 req/min rate limit
- $0.03 / 1,000 over-limit requests
- 50,000 AI credits / month
- Unlimited members
- MCP access & PPP adjustment
- Full historical FX data
- Analytics suite
- Bring your own AI keys (BYOK)
- Priority support
- OIDC Single Sign-On (SSO)
- Audit logs
Common questions
Is the MCP server included on every plan?
Yes. The MCP server is included on every CurrencyCore plan, including the free tier. Each successful tool call counts as one API request toward your monthly quota. No extra setup, no additional cost.
How do AI credits work?
1 AI credit = 1 query to the /v1/ai natural-language endpoint on CurrencyCore's models. The free tier includes 100 AI credits per month. AI credits and API requests are separate pools. You can top up AI credits any time via the dashboard without changing your plan.
Can I use the Free plan commercially?
Yes. Commercial use is allowed on every plan, including Free. You can use the API in paid products, client work, and internal business systems. The Free plan is limited by its 1,000-request monthly quota and 60 requests-per-minute rate limit, not by a commercial-use restriction. Standard acceptable-use rules still apply, including the ban on reselling the API as a standalone data feed.
How far back does historical data go, and do I need a paid plan?
The dataset covers 40 published pairs. GBP/USD and USD/INR include documented parities from 1949, major USD pairs have daily data from 1971, and EUR pairs begin in 1999. The free tier includes the last 30 days of history. Starter and above unlock the full dataset, while the /v1/history/analysis endpoint requires Growth.
Where does the rate data come from?
Live and recent daily rates are European Central Bank reference rates. Historical series come from the Federal Reserve H.10 release via FRED, supplemented by documented pre-float parities for GBP and INR. PPP factors come from the IMF PPPEX indicator and are updated annually.
Can I bring my own AI model?
Yes. Growth plan and higher supports Bring Your Own Key (BYOK): connect your own OpenAI, Anthropic, Azure, or any OpenAI-compatible model. When your provider answers, the call is billed as one API request per tool call and uses no AI credits. If the provider fails and fallback answers, it uses 1 AI credit instead.