Central Bank Rates MCP Server
Central Bank Rates MCP Server — @allratestoday/central-bank-mcp
コンプライアンス、税務、会計が実際に必要とする公式為替レートをAIアシスタントに提供します。Claude Code、Cursor、Claude Desktop、Windsurf、およびMCP互換の任意のクライアントが、ECB、Fed、Bank of Japan、HMRC、US Treasuryなど60以上の機関が公表する中央銀行・税務当局レートを、AllRatesToday API経由で取得できるModel Context Protocolサーバーです。
インストール後、アシスタントは次のような質問に答えることができます:
「今日のECB公式USD/EURレートは?」
「この3月の請求書にはどのHMRCレートを使うべき?」
「Bank of Japanの公式レートを第1四半期の毎日分表示して。」
「USD/LKRの公式レートを、公表しているすべての中央銀行で比較して。」
⚖️ 公式レートとミッドマーケットレート
このサーバーが返すものはすべて公式公表レートです。機関が公表した時点で固定され、その機関自身の公表日が付与されます。これは税務当局、監査人、税関が要求する数値です。ライブの市場レートではありません。ライブのミッドマーケットレート(価格表示、換算、市場に追従すべきあらゆる用途)には、関連サーバー @allratestoday/mcp-server を使用してください。両者は数パーセント乖離することがあります。用途に応じて選択してください。方法論: allratestoday.com/official-rates-methodology。
Related MCP server: plinth-fx-mcp
🚀 このサーバーの特長
🏛️ 60以上の公式ソース — 中央銀行(ECB、Fed、BOJ、SNB、RBI、…)に加え、税務当局(HMRC、US Treasury、…)。それぞれが独自の公表テーブルから提供されます
📅 時点正確性 — 任意の日付を指定可能。週末・祝日は法的に効力のあるレートにロールバックされ、応答には適用された公表日が示されます
📊 銀行間比較 — 1回の呼び出しで、ある通貨ペアに対する全機関のレートを、最小値・最大値・中央値・スプレッド統計とともに返します
🧮 誠実な導出 — 銀行が直接公表していないペアは、その銀行自身のテーブル内でのみ交差計算され、
derivedとフラグ付けされます。銀行が混在することはありません🧰 5つの焦点を絞ったツール — 表面が小さく、モデルが正しく使いやすい
🔌 MCPが動作するすべての環境で動作 — stdioトランスポート、MCP 1.x。Claude Code、Cursor、Claude Desktop、Windsurf、または任意の汎用ホスト
🔑 APIキーを取得
サーバーは有効な ALLRATES_API_KEY なしでは起動しません。無料キーは最新の公表テーブルをカバーします — クレジットカードは不要です。日付指定テーブルと履歴は有料プランが必要です。
allratestoday.com/register で登録 — 30秒
メールを確認する
ダッシュボードからキーをコピーする(形式:
art_live_xxxxx)以下の設定で
ALLRATES_API_KEYとして使用する
📦 インストール
# Run without installing (recommended)
npx -y @allratestoday/central-bank-mcp# Or install globally
npm install -g @allratestoday/central-bank-mcp
central-bank-mcp両方のコマンドはstdio MCPサーバーを起動し、クライアントの接続を待ちます — MCPクライアントがサブプロセスとして起動します。
🏁 クライアント別クイックセットアップ
Claude Code
claude mcp add central-bank-rates -- npx -y @allratestoday/central-bank-mcp
claude mcp env central-bank-rates ALLRATES_API_KEY=art_live_xxxxxClaude Codeを再起動します。「どの中央銀行から公式レートを取得できますか?」 と質問して確認します。
Cursor
~/.cursor/mcp.json(またはプロジェクト内の .cursor/mcp.json)を編集します:
{
"mcpServers": {
"central-bank-rates": {
"command": "npx",
"args": ["-y", "@allratestoday/central-bank-mcp"],
"env": {
"ALLRATES_API_KEY": "art_live_xxxxx"
}
}
}
}Claude Desktop
claude_desktop_config.json(Settings → Developer → Edit Config)を編集し、上記のCursorの例と同じ mcpServers ブロックを追加して、Claude Desktopを再起動します。
🧰 ツール
Tool | 機能 | プラン |
| カバーされる全機関。コード、メタデータ、最新日付 | 無料 |
| 銀行の公表テーブル(または1ペア)。最新または指定日付 | 無料(最新)/ 有料(日付指定) |
| 1ペアの日別公式系列 | 有料、対象月あたり約1コールとして請求 |
| 全銀行にわたる1ペア。スプレッド統計付き | 無料 |
| 銀行が実際に公表した日付(値は含まない) | 無料 |
🔒 プライバシー
allratestoday.comに送信されるのはリクエストパラメータとAPIキーのみです — 会話のコンテキストが送信されることはありません。
📚 AllRatesTodayのその他の情報
@allratestoday/mcp-server— ライブミッドマーケットレートMCPサーバー
ライセンス
MIT © AllRatesToday
Available Tools
6 toolscompare_official_ratesCompare one pair across every bankARead-only
Use this when the user wants one currency pair across ALL institutions at once — 'what does each central bank say USD/EUR is?', 'spread between official USD/LKR rates', 'which bank has the highest official rate for X?'. One call returns every covered bank's latest official rate for the pair plus spread stats { min, max, median, spread_bps } over fresh sources (stale quarterly publishers are returned but excluded from stats). Rates a bank doesn't publish directly are cross-computed within that bank's own table only — banks are never mixed. Methodology: https://allratestoday.com/official-rates-methodology/
Inputs: source (required), target (required).
get_official_rate_historyGet a bank's official rate historyARead-only
Use this for a date-by-date series of one bank's OFFICIAL rates — 'ECB USD rate for every day of 2025', 'how did the CBSL official rate move last quarter'. Returns one row per published date: { series: [{ date, rate, rate_type, derived, method }] }. Give either symbol (matches either side of the pair vs the bank's home currency) or a source+target pair. Defaults to the last year when from/to omitted. Paid plans only, and BILLED BY VOLUME: one API call per month of history covered (a year-long series costs ~12 calls) — keep ranges as narrow as the question needs. For publication dates without values (free) use get_publication_calendar.
Inputs: bank (required), to, from, source, +2 more.
get_official_ratesGet a bank's official published ratesARead-only
Use this for OFFICIAL rates a specific institution published — 'what is the ECB rate for USD?', 'Bank of Japan official rate on 2026-03-14', 'HMRC rate for invoicing'. These are the fixed rates in force for compliance, tax, customs, and accounting — NOT live market rates. Omit date for the newest published table; give date (paid plans) for the table in force on that day (weekends/holidays roll back to the last published date — the response's rate_date says which). Omit source/target for the bank's full table { rates: [{ base, quote, type, value }] }; give both for one pair — with an API key, pairs not directly published are cross-computed via the bank's own home currency and flagged derived; keyless serves only published pairs and their inverses. For live mid-market rates use the @allratestoday/mcp-server package instead.
Inputs: bank (required), date, source, target.
get_publication_calendarGet a bank's publication calendarARead-only
Use this to see WHICH dates a bank actually published a rate table — 'did the ECB publish on 2026-01-01?', 'how often does the US Treasury publish?'. Returns dates only, no rate values, so it is available on every plan (unlike history). Gaps reveal weekends, holidays, and weekly/quarterly publication cadence. Give ?year=YYYY or a from/to range; large ranges are capped and flagged truncated.
Inputs: bank (required), to, from, year.
list_central_banksList covered central banks & tax authoritiesARead-only
Call this FIRST when you need a bank code, or when the user asks 'which central banks do you cover?' or 'do you have rates from X?'. Returns { banks: [{ code, name, country, home_ccy, rate_types, latest date, ... }], disclaimer } for 130+ central banks and tax authorities (plus a composite) — central banks (ECB, Fed, BOJ, ...) plus tax authorities (HMRC, US Treasury, ...). The code field is what every other tool takes as its bank parameter. Cheap to call.
Inputs: no named parameters.
request_trial_keyRequest a trial API keyA
Self-issue an AllRatesToday API key with 100 lifetime calls, valid 7 days, with no account and no email. Use it when another tool answered "needs an API key" and the user wants a dated central-bank table, a history series, a cross-bank comparison or a publication calendar right now. The key is adopted by this server for the rest of the session and returned once — tell the user to put it in the MCP config as ALLRATES_API_KEY to keep it. Capped at 3 keys per IP per day. For a lasting key, register at https://allratestoday.com/register (free) or see https://allratestoday.com/pricing.
Inputs: agent, purpose. Returns: key, note, calls, adopted, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct axis: enumerating banks, fetching a bank's official table, fetching a per-date series, comparing across banks for one pair, and listing publication dates only. The descriptions explicitly disambiguate the riskiest overlaps (get_official_rates vs compare_official_rates, history vs calendar) and even steer users to a different package for live market rates.
All names follow a strict snake_case verb_noun pattern (list_central_banks, get_official_rates, get_official_rate_history, compare_official_rates, get_publication_calendar, request_trial_key). The single auth-related tool still fits the same convention, so there is no style drift.
Six tools is tight and well-scoped for a rates data server: one discovery tool, three rate-query tools at different granularity, one comparison aggregator, and one key-bootstrap tool. Nothing looks redundant or padded.
The core lifecycle is covered: discover banks, get latest/dated official tables, get history series, cross-bank comparison, and publication cadence, plus a way to obtain a key. Minor gaps remain — no tool to inspect key status/quota usage, no explicit currency-conversion or bulk multi-pair fetch, so an agent hitting billing limits must infer state from errors.
Maintenance
Related MCP Connectors
Live FX + official central-bank rates, 110+ sources. Hosted, keyless, nothing to install.
Official exchange rates from central banks: latest & historical rates plus currency conversion.
ExchangeRate MCP — wraps open.er-api.com (free, no auth)
Indicative fiat and crypto rates over MCP, paid per request via x402 at $0.0001/request.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceReal-time currency exchange rates and crypto prices via MCP. Convert between 60+ fiat currencies and 30+ cryptocurrencies with multi-source failover. No API keys needed for upstream data.ISC
- -licenseNot gradedqualityNot gradedmaintenanceMCP server that provides real exchange-rate data from the European Central Bank, including latest rates, currency conversion, historical rates, and time series.-
- AlicenseNot gradedqualityBmaintenanceConvert currencies, get FX rates, and query historical ECB exchange rate data via MCP.233 npm1Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables querying official Brazilian Central Bank currency exchange rates and quotes through a read-only MCP tool, with pay-per-use prepaid credits.MIT