API Reference

MCP Server

Connect Claude, Cursor, VS Code, Gemini, and other AI assistants to CurrencyCore over the Model Context Protocol (MCP) — live FX rates, conversion, and PPP, with OAuth.

CurrencyCore runs a hosted MCP (Model Context Protocol) server so AI assistants can call the API directly — convert currencies, pull exchange rates, and apply PPP, all from natural language.

https://mcp.currency-core.com/mcp

It’s a remote, Streamable-HTTP MCP server with OAuth: the first time a client connects, it opens a browser to sign in to CurrencyCore and pick an organization. Calls then run against that org exactly like a normal API key — same rate limits, usage metering, and billing.

What it exposes

Tools

Tool	Does
`convert`	Convert an amount between currencies, optionally PPP-adjusted
`get_rates`	Full USD-base exchange-rate snapshot for a date
`get_rates_by_base`	The snapshot re-expressed against any base currency
`list_countries`	Supported countries + their official currencies

Resources — these API docs, readable in-client. Prompts — guided workflows: convert with PPP, compare cost-of-living, build a rate table, explain an error.

Install

The connector is published as a small open repo — github.com/logn10/currency-core-mcp — with manifests for each client. Pick yours:

Claude Code

claude plugin marketplace add logn10/currency-core-mcp
claude plugin install currency-core-mcp@currencycore
# then in a session: /mcp → currency-core → Authenticate

Cursor

Add to Cursor, or add to Cursor Settings → MCP / .cursor/mcp.json:

{
  "mcpServers": {
    "currency-core": { "url": "https://mcp.currency-core.com/mcp" }
  }
}

VS Code (Copilot / MCP)

Add to .vscode/mcp.json (or user settings under "mcp"):

{
  "servers": {
    "currency-core": { "type": "http", "url": "https://mcp.currency-core.com/mcp" }
  }
}

Gemini CLI

gemini extensions install https://github.com/logn10/currency-core-mcp

…or add to ~/.gemini/settings.json (Gemini uses httpUrl for streamable HTTP):

{
  "mcpServers": {
    "currency-core": { "httpUrl": "https://mcp.currency-core.com/mcp" }
  }
}

Any other MCP client

It’s a standard remote Streamable-HTTP server — point your client at https://mcp.currency-core.com/mcp and complete the browser sign-in on first use. (Deeplink schemes and per-client config keys change occasionally; if a one-click link misbehaves, the manual JSON snippets above are stable.)

Authentication & control

Org selection — each connection is bound to one organization (chosen on the consent screen). Reconnect to switch orgs.
Usage & billing — MCP requests count toward that org’s plan and limits, just like any API key, and are tracked separately so you can see how much came through MCP (Dashboard → Developer, the MCP server panel).
Enable / disable — flip the switch in that panel to immediately stop MCP traffic for the org without revoking anything.

Usage tips

PPP needs a country on every currency. Pass from=USD:USA and to=INR:IND — a currency alone can’t imply a country. See the /convert docs for the pairing rules.
amount defaults to 1, so omit it to get the raw effective rate.
Dates are UTC and can’t be in the future; omit date for the latest snapshot.
Just ask in plain language — e.g. “Convert 250 USD to EUR and INR, PPP-adjusted for Germany and India,” or “For the same basket of goods, is the US or India cheaper?” — the assistant picks the right tools.

Notes

The MCP server is a thin proxy over the public REST API — there’s nothing it can do that a normal API key can’t, and every call obeys the same authentication, limits & billing, and error handling.