MCP tool library

CurrencyCore MCP
tool call examples.

Real tool inputs, real outputs. These are the exact calls AI agents make through the MCP server.

convert

Live currency conversion at mid-market rate.

// input
{ from: "USD", to: "INR", amount: 500 }

// output
{ result: 42350, rate: 84.7, asOf: "2026-06-22" }
convert

PPP-adjusted price for India market. $99 in the US has the purchasing-power equivalent of about 2,019 INR in India.

// input
{ from: "USD", to: "INR", amount: 99, ppp: true,
  fromCountry: "USA", toCountry: "IND" }

// output
{ result: 2019, pppApplied: true, pppYear: 2024 }
get_rates

Full rate snapshot against USD. Returns all supported currencies in a single call.

// input
{ base: "USD" }

// output
{ rates: { EUR: 0.914, GBP: 0.786,
  JPY: 154.2, INR: 84.7 } }
get_history

Full year daily series for EUR. Every trading day rate for the calendar year.

// input
{ currency: "EUR", from: "2024-01-01",
  to: "2024-12-31" }

// output
{ rates: [ ...365 daily entries ] }
analyze_history

Trend analysis with change %, volatility, highs and lows over 5 years. Growth+ required.

// input
{ currencies: ["EUR", "GBP"], period: "5y" }

// output
{ EUR: { changePct: +12.4, volatility: 6.8,
  high: 1.12, low: 0.97 }, GBP: { ... } }
analyze_ppp

IMF PPP factor trend for USA vs India over 10 years. Shows how purchasing power parity has shifted. Growth+ required.

// input
{ fromCountry: "USA", toCountry: "IND",
  years: 10 }

// output
{ factors: [ ...10 annual entries ],
  trend: "converging" }
analyze_volatility

Annualized volatility ranking. Identifies the most and least stable currencies over any period. Growth+ required.

// input
{ currencies: ["TRY", "ARS", "INR", "EUR"],
  period: "1y" }

// output
{ ranked: [ { currency: "ARS", annualizedVol: 48.2 },
  { currency: "TRY", ... }, ... ] }
analyze_correlation

Pearson correlation: how closely EUR, GBP, and CHF move together over 3 years. Growth+ required.

// input
{ base: "EUR",
  currencies: ["GBP", "CHF"], period: "3y" }

// output
{ GBP: { pearson: 0.94 },
  CHF: { pearson: 0.81 } }
analyze_safe_haven

Safe-haven scoring: stability, crisis performance, and reserve status. Growth+ required.

// input
{ currencies: ["CHF", "JPY", "USD", "EUR"] }

// output
{ ranked: [ { currency: "CHF", score: 0.91 },
  { currency: "JPY", score: 0.87 }, ... ] }
list_countries

All supported countries with ISO currency codes. Resolves "India" to INR:IND without hallucinating codes.

// input
{}

// output
{ countries: [ { name: "India",
  currency: "INR", iso: "IND" }, ... ] }

Connect your agent.
13 tools. Every currency question.

Free tier: 1,000 requests per month. MCP included. No credit card required.

Get your free API key MCP documentation