MCP Server

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

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

It is 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, with the same rate limits, usage metering, and billing.

Plugins & extensions

We ship an official open-source plugin so you can connect in one command — no JSON to copy. One repo packages a Claude Code plugin (+ marketplace), a Gemini CLI extension, and the official MCP Registry manifest, all wired to the hosted server above:

→ github.com/CurrencyCore/currency-core-mcp

# Claude Code — add the marketplace, then install the plugin
claude plugin marketplace add CurrencyCore/currency-core-mcp
claude plugin install currency-core-mcp@currencycore

# Gemini CLI — install the extension straight from the repo
gemini extensions install https://github.com/CurrencyCore/currency-core-mcp

On first connect your client opens a browser to sign in and pick an org. Every other client connects with a one-line config — see Install below.

What it exposes

Tools

Tools are split by access level. Public tools require no authentication. Keyed tools require an authorized connection (OAuth sign-in). Analytics tools additionally require Growth plan or higher.

Core tools — all plans

Analytics tools — Growth+ only

These tools unlock on Growth plan and above. A free or starter org receives a 403 explaining the upgrade path when calling them.

Reference tools — no authentication required

Resources

The full API documentation — every endpoint, parameter, and response schema — is exposed as an MCP resource so your AI client can read it inline and generate accurate requests without leaving the conversation.

Prompts

Guided workflows available as MCP prompts:

• convert_with_ppp — convert an amount with PPP adjustment, with the right country codes pre-filled
• compare_cost_of_living — compare the real purchasing power of an amount across two countries
• build_rate_table — generate a formatted exchange-rate table for a set of currencies
• explain_error — diagnose an API error code and suggest a fix

Install

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Claude Code

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

Oh My Pi (omp)

omp plugin marketplace add CurrencyCore/currency-core-mcp
omp plugin install currency-core-mcp@currencycore
# first use opens a browser sign-in (or run: /mcp reauth currency-core)

Or add to .omp/mcp.json (project) or ~/.omp/agent/mcp.json (user) — omp needs "type": "http":

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

Cursor

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

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

Windsurf

Add to Windsurf Settings → MCP Servers:

{
  "mcpServers": {
    "currency-core": { "serverUrl": "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/CurrencyCore/currency-core-mcp

Or add to ~/.gemini/settings.json:

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

Any other MCP client

Point your client at https://mcp.currency-core.com/mcp and complete the browser sign-in on first use. The server speaks standard Streamable-HTTP MCP and works with any compliant client.

Authentication & control

• Org selection — each connection is bound to one organization chosen on the consent screen. Reconnect to switch orgs.
• Usage & billing — each successful tool call counts as one API request against that org’s plan and limits, tracked separately under Dashboard → Developer → MCP server panel. Every tool result carries the count in _meta (currencycore/tool_calls, currencycore/billed_requests) so you can reconcile usage from the client side.
• Enable / disable — flip the switch in the Developer 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 code alone cannot imply a country. See the convert endpoint docs for the pairing rules.
• amount defaults to 1, so omit it to get the raw effective rate.
• Dates are UTC and cannot be in the future; omit date for the latest snapshot.
• Analytics tools support a period shorthand — pass period=1y, period=5y, period=ytd, or period=6m instead of explicit from/to dates.
• Just ask in plain language — e.g. “How volatile has INR been compared to BRL over the last two years?” or “Which G10 currency had the worst drawdown in 2022?” — the assistant picks the right tool automatically.

Notes

The MCP server is a thin, authenticated proxy over the public REST API. Every call obeys the same authentication, rate limits & billing, and error handling. Analytics tools enforce the Growth+ entitlement at the API level — the server does not need to know your plan in advance.