Server definition
- Hash
- sha256:c1f8419feebc11c8c0ad5847b9cf4c32952e668f6617ce125575a3e3091cee1b
- What it is
- What a remote MCP server returned when asked what it offers: 14 tools
The blob, as servednamed by its sha256
{
"instructions": "CurrencyCore provides read-only FX, historical analysis, IMF PPP, and country/currency reference data. Route by intent: list_currencies/list_countries to resolve a code; convert for one pair or amount; get_rates for the USD rate table; get_rates_by_base for the same table in another base; get_history for one currency's series; analyze_history for change/trend/movers; analyze_volatility for dispersion or a stability ranking; analyze_correlation for co-movement; analyze_drawdown for peak-to-trough loss; analyze_safe_haven for crisis resilience; analyze_mean_reversion for reversion to the mean; get_ppp_factor for one country/year PPP multiplier; analyze_ppp for PPP change or a country ranking. Dates are UTC YYYY-MM-DD. All tools are read-only. Keyed tools need an OAuth connection and bill 1 API request on success; analytics tools require Growth or higher. An omitted date uses the latest available date, which is not necessarily today. Rate-limit responses are 429 and carry a Retry-After hint.",
"tools": [
{
"description": "Return the Pearson correlation of each currency's daily returns with `base` over a window (−1..1), plus the number of overlapping observations. Use for diversification or co-movement questions such as \"does CHF track EUR?\". `currencies` is required and comma-separated; a non-USD `base` is usually more meaningful. Use `analyze_volatility` for dispersion and `analyze_history` for raw change. Defaults: 365-day window ending today. Returns `{ base, from, to, results[] }`; `correlation` is null when it is undefined for the window. Requires a signed-in connection and the Growth plan or higher; each successful call bills 1 API request.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"description": "Reference currency to correlate against (3-letter ISO 4217). Defaults to USD (a non-USD base is more meaningful).",
"type": "string"
},
"currencies": {
"description": "Comma-separated currencies to correlate with `base`, e.g. GBP,CHF,SEK.",
"type": "string"
},
"from": {
"description": "Window start YYYY-MM-DD (UTC). Defaults to 365 days before `to`.",
"type": "string"
},
"to": {
"description": "Window end YYYY-MM-DD (UTC). Defaults to today.",
"type": "string"
}
},
"required": [
"currencies"
],
"type": "object"
},
"name": "analyze_correlation",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"type": "string"
},
"from": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"correlation": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"note": {
"type": "string"
},
"observations": {
"type": "number"
}
},
"required": [
"currency",
"correlation",
"observations"
],
"type": "object"
},
"type": "array"
},
"to": {
"type": "string"
}
},
"required": [
"base",
"from",
"to",
"results"
],
"type": "object"
}
},
{
"description": "Return the worst peak-to-trough decline of each currency vs `base`, with peak, trough, and recovery dates/days. Use for \"how far did it fall and did it recover\" questions or to rank the deepest drawdowns. Omit `currency` to rank the universe (`sort` deepest or recovery); provide one currency or a list to compare. Use `analyze_volatility` for dispersion and `analyze_safe_haven` for crisis behaviour. Defaults: 365-day window, `base` USD, `sort` deepest, `universe` liquid, `limit` 10. Returns `{ base, from, to, mode, results[] }`; peak/trough dates are omitted and recovery fields are null when there is no drawdown or recovery in the window. Requires a signed-in connection and the Growth plan or higher; each successful call bills 1 API request.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"description": "Base currency to measure against (3-letter ISO 4217). Defaults to USD.",
"type": "string"
},
"currency": {
"description": "Currency to measure (3-letter ISO 4217), or a comma-separated list. OMIT to RANK the liquid set by drawdown.",
"type": "string"
},
"from": {
"description": "Window start YYYY-MM-DD (UTC). Defaults to 365 days before `to`.",
"type": "string"
},
"limit": {
"description": "Ranking: how many to return (default 10, max 50).",
"type": "number"
},
"sort": {
"description": "Ranking direction: deepest (largest decline first, default) or recovery (fastest recovery first).",
"enum": [
"deepest",
"recovery"
],
"type": "string"
},
"to": {
"description": "Window end YYYY-MM-DD (UTC). Defaults to today.",
"type": "string"
},
"universe": {
"description": "Ranking universe: liquid (default) or majors.",
"enum": [
"liquid",
"majors"
],
"type": "string"
}
},
"type": "object"
},
"name": "analyze_drawdown",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"type": "string"
},
"from": {
"type": "string"
},
"mode": {
"enum": [
"compare",
"ranking"
],
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"maxDrawdownPct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"note": {
"type": "string"
},
"peakDate": {
"type": "string"
},
"recoveryDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"recoveryDays": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"troughDate": {
"type": "string"
}
},
"required": [
"currency",
"maxDrawdownPct"
],
"type": "object"
},
"type": "array"
},
"sort": {
"enum": [
"deepest",
"recovery"
],
"type": "string"
},
"to": {
"type": "string"
},
"universe": {
"enum": [
"liquid",
"majors"
],
"type": "string"
}
},
"required": [
"base",
"from",
"to",
"mode",
"results"
],
"type": "object"
}
},
{
"description": "Summarise how currencies moved against `base` over a window: start/end rate, change %, strengthened % (positive = stronger vs base), and optional min/max/avg. Use for questions like \"how did EUR do over 10 years\" and for movers rankings. Omit `currencies` to rank the universe (movers mode); provide them to compare specific ones. Use `get_history` for raw points, and the other `analyze_*` tools for volatility, correlation, drawdown, safe-haven, or mean-reversion questions. Defaults: 20-year window, `base` USD, `sort` strengthened, `assetClass` fiat, `limit` 10, `stats` true. Returns `{ base, from, to, mode, sort?, assetClass?, stats, results[] }`. A 404 means no rate data at the window edges. Requires a signed-in connection and the Growth plan or higher; each successful call bills 1 API request.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assetClass": {
"description": "Movers universe: fiat (default, liquid tradeable currencies), metals (XAU/XAG/XPT/XPD), all (every currency including illiquid/frontier), or crypto (accepted, but this FX dataset has no crypto data, so results are empty). Redenomination artifacts are always dropped.",
"enum": [
"fiat",
"metals",
"all",
"crypto"
],
"type": "string"
},
"base": {
"description": "Currency everything is measured against (3-letter ISO 4217). Defaults to USD.",
"type": "string"
},
"currencies": {
"description": "Comma-separated currencies to compare, e.g. GBP,EUR,AED. OMIT to rank ALL currencies vs base ('movers' mode).",
"type": "string"
},
"from": {
"description": "Window start YYYY-MM-DD (UTC). Defaults to 20 years (2 decades) before `to`. See `period` for a shorthand.",
"type": "string"
},
"interval": {
"description": "Attach a trend series per named currency: weekly, monthly, or yearly (compare mode only).",
"enum": [
"daily",
"weekly",
"monthly",
"yearly"
],
"type": "string"
},
"limit": {
"description": "Movers: how many top results to return (default 10, max 200).",
"type": "number"
},
"period": {
"description": "Relative window shorthand for `from`: e.g. 10y, 6m, 30d, ytd, max. Ignored if `from` is given.",
"type": "string"
},
"sort": {
"description": "Movers ranking: strengthened (default) or weakened.",
"enum": [
"strengthened",
"weakened"
],
"type": "string"
},
"stats": {
"description": "Include min/max/avg over the window per currency. Defaults to true; pass false to skip.",
"type": "boolean"
},
"to": {
"description": "Window end YYYY-MM-DD (UTC). Defaults to today; a future date clamps to today.",
"type": "string"
}
},
"type": "object"
},
"name": "analyze_history",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assetClass": {
"enum": [
"fiat",
"metals",
"all",
"crypto"
],
"type": "string"
},
"base": {
"type": "string"
},
"from": {
"type": "string"
},
"interval": {
"enum": [
"daily",
"weekly",
"monthly",
"yearly"
],
"type": "string"
},
"mode": {
"enum": [
"compare",
"movers"
],
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"changePct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"endDate": {
"type": "string"
},
"endRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"note": {
"type": "string"
},
"series": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"startDate": {
"type": "string"
},
"startRate": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"stats": {
"additionalProperties": false,
"properties": {
"avg": {
"type": "number"
},
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"required": [
"min",
"max",
"avg"
],
"type": "object"
},
"strengthenedPct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"volatility": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"currency",
"startDate",
"endDate",
"startRate",
"endRate",
"changePct",
"strengthenedPct"
],
"type": "object"
},
"type": "array"
},
"sort": {
"enum": [
"strengthened",
"weakened"
],
"type": "string"
},
"stats": {
"type": "boolean"
},
"to": {
"type": "string"
}
},
"required": [
"base",
"from",
"to",
"mode",
"stats",
"results"
],
"type": "object"
}
},
{
"description": "Rank currencies by how strongly they revert to their historical mean, using a composite 0–100 score (crossing frequency + reversion half-life), plus current deviation and half-life in days. Use for questions like \"does EUR snap back to its average\". Provide `currencies` to score specific codes, or omit to rank the liquid set. Use `analyze_history` for raw change and `analyze_volatility` for dispersion. Defaults: roughly a 2-year window, `base` USD, `limit` 10. Returns `{ base, from, to, results[] }`; `score` and `halfLifeDays` are null when there is not enough reverting data. Requires a signed-in connection and the Growth plan or higher; each successful call bills 1 API request.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"description": "Base currency to measure against (3-letter ISO 4217). Defaults to USD.",
"type": "string"
},
"currencies": {
"description": "Comma-separated currencies to score, e.g. EUR,GBP. OMIT to rank the liquid set.",
"type": "string"
},
"from": {
"description": "Window start YYYY-MM-DD (UTC). Defaults to ~2 years before `to`.",
"type": "string"
},
"limit": {
"description": "How many to return (default 10, max 50).",
"type": "number"
},
"to": {
"description": "Window end YYYY-MM-DD (UTC). Defaults to today.",
"type": "string"
}
},
"type": "object"
},
"name": "analyze_mean_reversion",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"type": "string"
},
"from": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"deviationPct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"halfLifeDays": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"note": {
"type": "string"
},
"reversionFrequency": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"currency",
"score",
"deviationPct",
"reversionFrequency",
"halfLifeDays"
],
"type": "object"
},
"type": "array"
},
"to": {
"type": "string"
},
"universe": {
"enum": [
"liquid",
"majors"
],
"type": "string"
}
},
"required": [
"base",
"from",
"to",
"results"
],
"type": "object"
}
},
{
"description": "Measure how a country's IMF PPP conversion factor changed over a year window: start/end year and factor, % change, and optional min/max/avg. Use for purchasing-power trends and cross-country PPP rankings. Omit `countries` to rank all countries (movers); provide ISO alpha-3 codes to compare specific ones. Use `get_ppp_factor` for a single country/year value, and `convert` with `ppp=true` to price an amount. Defaults: 10-year window, `sort` increased, `limit` 10, `stats` true. Returns `{ from, to, mode, stats, results[] }`, with `projected: true` marking an IMF projection. Returns an error when no PPP data exists in the window. Requires a signed-in connection and the Growth plan or higher; each successful call bills 1 API request.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"countries": {
"description": "Comma-separated ISO 3166-1 alpha-3 country codes to compare, e.g. IND,DEU,USA. OMIT to rank ALL countries by PPP-factor change ('movers' mode).",
"type": "string"
},
"from": {
"description": "Window start YEAR (e.g. 2015). Defaults to 10 years before `to`. See `period` for a shorthand.",
"type": "string"
},
"limit": {
"description": "Movers: how many top results to return (default 10, max 200).",
"type": "number"
},
"period": {
"description": "Relative window shorthand for `from`: e.g. 10y, 20y, max. Ignored if `from` is given.",
"type": "string"
},
"sort": {
"description": "Movers ranking: increased (PPP factor rose most, default) or decreased.",
"enum": [
"increased",
"decreased"
],
"type": "string"
},
"stats": {
"description": "Include min/max/avg of the PPP factor over the window per country. Defaults to true; pass false to skip.",
"type": "boolean"
},
"to": {
"description": "Window end YEAR (e.g. 2024). Defaults to the current year.",
"type": "string"
}
},
"type": "object"
},
"name": "analyze_ppp",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"from": {
"type": "number"
},
"mode": {
"enum": [
"compare",
"movers"
],
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"changePct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"country": {
"type": "string"
},
"endFactor": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"endYear": {
"type": "number"
},
"note": {
"type": "string"
},
"projected": {
"type": "boolean"
},
"series": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"startFactor": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"startYear": {
"type": "number"
},
"stats": {
"additionalProperties": false,
"properties": {
"avg": {
"type": "number"
},
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"required": [
"min",
"max",
"avg"
],
"type": "object"
}
},
"required": [
"country",
"startYear",
"endYear",
"startFactor",
"endFactor",
"changePct",
"projected"
],
"type": "object"
},
"type": "array"
},
"sort": {
"enum": [
"increased",
"decreased"
],
"type": "string"
},
"stats": {
"type": "boolean"
},
"to": {
"type": "number"
}
},
"required": [
"from",
"to",
"mode",
"stats",
"results"
],
"type": "object"
}
},
{
"description": "Rank currencies by a 0–100 safe-haven score that combines low volatility, shallow drawdown, and 2008-crisis resilience. Use for \"which currency holds up in a crisis\" questions. Provide `currencies` to score specific codes, or omit to rank the liquid-fiat pool. Precious metals are not supported. Use `analyze_volatility` for pure dispersion and `analyze_drawdown` for peak-to-trough loss. Defaults: window from 2007-01-01 (or 20 years before `to`), `base` USD, `limit` 10. Returns `{ base, from, to, crisis, results[] }`. Returns an error when no rate data is available for the window. Requires a signed-in connection and the Growth plan or higher; each successful call bills 1 API request.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"description": "Base currency to measure against (3-letter ISO 4217). Defaults to USD.",
"type": "string"
},
"currencies": {
"description": "Comma-separated currencies to score, e.g. CHF,JPY. OMIT to rank the liquid-fiat safe-haven pool (precious metals are not supported).",
"type": "string"
},
"from": {
"description": "Window start YYYY-MM-DD (UTC). Defaults to 2007-01-01 (spans the 2008 crisis + COVID), or to 20 years before `to` when that is later.",
"type": "string"
},
"limit": {
"description": "How many to return (default 10, max 50).",
"type": "number"
},
"to": {
"description": "Window end YYYY-MM-DD (UTC). Defaults to today.",
"type": "string"
}
},
"type": "object"
},
"name": "analyze_safe_haven",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"type": "string"
},
"crisis": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"label": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"label",
"from",
"to"
],
"type": "object"
},
"from": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"crisisReturnPct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"maxDrawdownPct": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"note": {
"type": "string"
},
"score": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"volatility": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"currency",
"score",
"volatility",
"maxDrawdownPct",
"crisisReturnPct"
],
"type": "object"
},
"type": "array"
},
"to": {
"type": "string"
},
"universe": {
"enum": [
"liquid",
"majors"
],
"type": "string"
}
},
"required": [
"base",
"from",
"to",
"crisis",
"results"
],
"type": "object"
}
},
{
"description": "Return annualized volatility (%) for each currency against `base`, with the number of daily returns used. Use to rank stability or find the most volatile currency or pair. Omit `currency` to rank the universe (`sort` stable or volatile); provide one currency or a comma-separated list to compare. Use `analyze_drawdown` for worst peak-to-trough loss and `analyze_safe_haven` for crisis resilience. Defaults: 365-day window, `base` USD, `sort` stable, `universe` liquid, `limit` 10. Returns `{ base, from, to, mode, basis, results[] }`; `volatility` is null when there is too little data. Requires a signed-in connection and the Growth plan or higher; each successful call bills 1 API request.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"description": "Base currency to measure against (3-letter ISO 4217). Defaults to USD.",
"type": "string"
},
"currency": {
"description": "Currency to measure (3-letter ISO 4217), or a comma-separated list to compare. OMIT to RANK the liquid-currency set by stability.",
"type": "string"
},
"from": {
"description": "Window start YYYY-MM-DD (UTC). Defaults to 365 days before `to`.",
"type": "string"
},
"limit": {
"description": "Ranking: how many to return (default 10, max 50).",
"type": "number"
},
"sort": {
"description": "Ranking direction: stable (least volatile first, default) or volatile.",
"enum": [
"stable",
"volatile"
],
"type": "string"
},
"to": {
"description": "Window end YYYY-MM-DD (UTC). Defaults to today; a future date clamps to today.",
"type": "string"
},
"universe": {
"description": "Ranking universe: liquid (default, broad set) or majors (USD/EUR/GBP/JPY/CHF/CAD/AUD/NZD). Use majors for 'most volatile major pair'.",
"enum": [
"liquid",
"majors"
],
"type": "string"
}
},
"type": "object"
},
"name": "analyze_volatility",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"type": "string"
},
"basis": {
"const": "annualized-daily",
"type": "string"
},
"from": {
"type": "string"
},
"mode": {
"enum": [
"compare",
"ranking"
],
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"note": {
"type": "string"
},
"observations": {
"type": "number"
},
"volatility": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"currency",
"volatility",
"observations"
],
"type": "object"
},
"type": "array"
},
"sort": {
"enum": [
"stable",
"volatile"
],
"type": "string"
},
"to": {
"type": "string"
},
"universe": {
"enum": [
"liquid",
"majors"
],
"type": "string"
}
},
"required": [
"base",
"from",
"to",
"mode",
"basis",
"results"
],
"type": "object"
}
},
{
"description": "Convert an amount from one currency to one or more targets at the reference rate for `date`, optionally PPP-adjusted. Use for any single-pair or amount conversion (for example \"100 USD to EUR\"). Use `get_rates`/`get_rates_by_base` for a full rate table, `get_history` for a series, and the `analyze_*` tools for statistics. `amount` defaults to 1 (each result then equals the rate); `ppp=true` applies purchasing-power parity and needs `CUR:COUNTRY` when a currency is used in more than one country; `date` must be today or earlier and defaults to the latest rate date. Returns `{ from, amount, date, results[] }`, each result carrying `result`, `rate`, and an optional `ppp` block. Invalid codes or dates return a 4xx error; no rate for the date is a 404. Requires a signed-in connection; each successful call bills 1 API request.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"amount": {
"description": "Amount to convert. Optional, defaults to 1 (so each result equals the rate). When provided it must be a finite positive number.",
"type": "number"
},
"date": {
"description": "Rate date in YYYY-MM-DD (UTC). Must not be in the future. Defaults to latest.",
"type": "string"
},
"from": {
"description": "Source currency (ISO 4217), e.g. USD. For PPP (ppp=true), pass CUR:COUNTRY (e.g. USD:USA) when the currency is used in more than one country; common currencies are resolved automatically.",
"type": "string"
},
"ppp": {
"description": "When true, apply a PPP adjustment. Pass CUR:COUNTRY for currencies used in more than one country; common currencies (USD, EUR, INR and others) resolve automatically.",
"type": "boolean"
},
"to": {
"description": "One or more target currencies, comma-separated, e.g. EUR,INR (max 25). For PPP, pass CUR:COUNTRY pairs (e.g. EUR:DEU,INR:IND) when a currency is used in more than one country; common currencies are resolved automatically.",
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"name": "convert",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"amount": {
"type": "number"
},
"asOf": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"date": {
"type": "string"
},
"from": {
"type": "string"
},
"fromCountry": {
"type": "string"
},
"message": {
"type": "string"
},
"requestedDate": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"ppp": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"fromFactor": {
"type": "number"
},
"result": {
"type": "number"
},
"source": {
"type": "string"
},
"toFactor": {
"type": "number"
},
"year": {
"type": "number"
}
},
"required": [
"fromFactor",
"toFactor",
"result",
"year",
"source"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"type": "string"
}
},
"required": [
"error"
],
"type": "object"
}
]
},
"rate": {
"type": "number"
},
"result": {
"type": "number"
},
"to": {
"type": "string"
},
"toCountry": {
"type": "string"
}
},
"required": [
"to",
"result",
"rate"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"from",
"amount",
"date",
"results"
],
"type": "object"
}
},
{
"description": "Return one currency's rate series over a date range, expressed against `base`: `rates` maps each date (or aggregated period) to units of `currency` per 1 `base`. Use for a line chart or raw daily/weekly/monthly/yearly points for one currency. Use `analyze_history` for computed change, trend, and movers; use `convert` or `get_rates` for a single value or snapshot. Defaults: `to` today, `from` 7 days earlier, `base` USD, `interval` daily; coarser intervals average the daily rates per bucket. Returns `{ currency, base, interval, from, to, rates }`. Free plans are limited to the last 30 days; an invalid code or missing history is a 404. Requires a signed-in connection; each successful call bills 1 API request.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"description": "Base currency the rates are expressed against (3-letter ISO 4217). Defaults to USD.",
"type": "string"
},
"currency": {
"description": "The currency whose history to fetch (3-letter ISO 4217), e.g. INR. One currency per call.",
"type": "string"
},
"from": {
"description": "Start date YYYY-MM-DD (UTC). Defaults to 7 days before `to`.",
"type": "string"
},
"interval": {
"description": "Aggregation: daily (default), weekly, monthly, or yearly. Coarser intervals average the daily rates per bucket (weekly key = the week's Monday, monthly = YYYY-MM, yearly = YYYY).",
"enum": [
"daily",
"weekly",
"monthly",
"yearly"
],
"type": "string"
},
"to": {
"description": "End date YYYY-MM-DD (UTC). Defaults to today; a future date clamps to today.",
"type": "string"
}
},
"required": [
"currency"
],
"type": "object"
},
"name": "get_history",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"type": "string"
},
"currency": {
"type": "string"
},
"from": {
"type": "string"
},
"interval": {
"enum": [
"daily",
"weekly",
"monthly",
"yearly"
],
"type": "string"
},
"rates": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"to": {
"type": "string"
}
},
"required": [
"currency",
"base",
"interval",
"from",
"to",
"rates"
],
"type": "object"
}
},
{
"description": "Return the IMF World Economic Outlook PPP conversion factor for one country and year: local currency units per international dollar. Use when the user needs the raw multiplier for one country/year, for example a cost-of-living comparison. Use `convert` with `ppp=true` to price an amount, and `analyze_ppp` for change over time or a cross-country ranking. `year` defaults to the latest configured PPP year (2024). Returns `{ year, countryCode, pppFactor, projected }`; `projected: true` marks an IMF projection rather than observed data. An unknown country or year is a 404. Requires a signed-in connection; each successful call bills 1 API request.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"country": {
"description": "Country as an ISO 3166-1 alpha-3 code (e.g. IND).",
"type": "string"
},
"year": {
"description": "Four-digit year. Defaults to the configured current PPP year (2024).",
"type": "number"
}
},
"required": [
"country"
],
"type": "object"
},
"name": "get_ppp_factor",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"countryCode": {
"type": "string"
},
"pppFactor": {
"type": "number"
},
"projected": {
"type": "boolean"
},
"year": {
"type": "number"
}
},
"required": [
"year",
"countryCode",
"pppFactor",
"projected"
],
"type": "object"
}
},
{
"description": "Return the full USD-based exchange-rate snapshot for one date: `rates` maps every supported currency to units per 1 USD. Use when the user wants a multi-currency table in USD (for example \"today's rates\"). Use `get_rates_by_base` for a non-USD base, `convert` for one pair or amount, and `get_history` for a time series. Omitting `date` returns the latest available snapshot, which is not necessarily today. Returns `{ base: \"USD\", date, rates }`; a date with no snapshot is a 404. Requires a signed-in connection; each successful call bills 1 API request.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"date": {
"description": "YYYY-MM-DD. Defaults to the latest available date.",
"type": "string"
}
},
"type": "object"
},
"name": "get_rates",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"asOf": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"base": {
"const": "USD",
"type": "string"
},
"date": {
"type": "string"
},
"rates": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"requestedDate": {
"type": "string"
}
},
"required": [
"date",
"base",
"rates"
],
"type": "object"
}
},
{
"description": "Return the daily FX snapshot re-based to `base`: every supported currency quoted as units per 1 unit of `base`, with `base` itself at 1. Use when the user wants a multi-currency table in a non-USD base (for example \"rates in EUR\"). Use `get_rates` for the USD table, `convert` for one pair or amount, and `get_history` for a time series. Omitting `date` returns the latest available snapshot, which is not necessarily today. Returns `{ base, date, rates }`; an unsupported base or a date with no snapshot is a 404. Requires a signed-in connection; each successful call bills 1 API request.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"base": {
"description": "Base currency (3-letter ISO 4217), e.g. EUR.",
"type": "string"
},
"date": {
"description": "YYYY-MM-DD. Defaults to the latest available date.",
"type": "string"
}
},
"required": [
"base"
],
"type": "object"
},
"name": "get_rates_by_base",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"asOf": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"base": {
"type": "string"
},
"date": {
"type": "string"
},
"ppp": {
"additionalProperties": false,
"properties": {
"base": {
"type": "string"
},
"values": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"year": {
"type": "number"
}
},
"required": [
"base",
"year",
"values"
],
"type": "object"
},
"rates": {
"additionalProperties": {
"type": "number"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"requestedDate": {
"type": "string"
}
},
"required": [
"base",
"date",
"rates"
],
"type": "object"
}
},
{
"description": "Return the supported countries and their official currencies as an array of `{ code, name, currencies }`. Use to resolve a country name to its ISO alpha-3 code before `get_ppp_factor` or `analyze_ppp`, or to check which countries are covered. Use `list_currencies` for currency codes. Returns the full list in one call and takes no parameters. Public tool: no sign-in and no API request billed.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "list_countries",
"outputSchema": null
},
{
"description": "Return the full ISO 4217 currency catalogue as an array of `{ code, numeric, name, symbol }`. Use to resolve a currency name or symbol to its code, or to confirm a currency is supported before calling another tool, so a typo fails at selection rather than silently. Use `list_countries` for country codes. Non-ISO codes CNH, GGP, IMP, and JEP have an empty `numeric`. Returns the full list in one call and takes no parameters. Public tool: no sign-in and no API request billed.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "list_currencies",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:c1f8419feebc11c8c0ad5847b9cf4c32952e668f6617ce125575a3e3091cee1b | sha256sum