Central Bank Rates (AllRatesToday)

中央銀行レート MCP サーバー — @allratestoday/central-bank-mcp

Webサイト：https://allratestoday.com/central-bank-rates-api/ · ホスト型エンドポイント（インストール不要）：https://allratestoday.com/api/mcp · ドキュメント：https://allratestoday.com/mcp/

コンプライアンス、税務、会計で実際に必要となる公式為替レートを、AI アシスタントで利用できます。Claude Code、Cursor、Claude Desktop、Windsurf、および MCP 互換のあらゆるクライアントが、122 の中央銀行と 4 つの税務当局（ECB、Fed、日本銀行、HMRC、米国財務省など）が公表するレートを、AllRatesToday API経由で取得できる Model Context Protocol サーバーです。

インストールすると、アシスタントは次のような質問に答えられるようになります。

• 「今日のECB公式USD/EURレートはいくらですか？」
• 「この3月の請求書には、どのHMRCレートを使えばよいですか？」
• 「第1四半期の各日の日本銀行公式レートを表示してください。」
• 「公式USD/LKRレートを公表しているすべての中央銀行について、レートを比較してください。」

⚖️ 公式レートと仲値

このサーバーが返すのはすべて公表済みの公式レートです。機関が公表した時点で確定し、その機関独自の公表日が付与されます。税務当局、監査人、税関が必要とする数値です。リアルタイムの市場レートではありません。 リアルタイムの仲値（価格表示、換算など、市場に連動させるべき用途）には、関連サーバーの @allratestoday/mcp-serverを使用してください。用途によって使い分けてください。両者には数パーセントの差が生じることがあります。算出方法：allratestoday.com/official-rates-methodology。

🚀 このサーバーを選ぶ理由

• 🏛️ 122 の中央銀行と 4 つの税務当局 — 中央銀行（ECB、Fed、BOJ、SNB、RBI、…）に加え、税務当局（HMRC、米国財務省、…）にも対応。それぞれの機関が独自に公表する表からレートを提供します
• 📅 時点の正確性 — 任意の日付を指定できます。週末や祝日は法的に有効なレートまでさかのぼり、適用された公表日を応答で知らせます
• 📊 複数銀行の比較 — 1 回の呼び出しで、通貨ペアの各機関のレートと、最小値／最大値／中央値、スプレッドの統計を取得できます
• 🧮 誠実な派生レート — API キーを使用すると、銀行が直接公表していない通貨ペアは、その銀行独自の表内でのみ相互計算し、derived として示します。銀行間でデータを混ぜることはありません。API キーなしの場合は、公表済みの通貨ペアとその逆方向のレートのみを提供します
• 🔓 API キー不要で利用可能 — インストール後すぐに使えます。すべてのソースの最新の公表表を公開しています
• 🧰 目的に特化した 6 つのツール — 機能を絞り、モデルが正しく使いやすい設計です
• 🔌 MCP 対応環境ならどこでも動作 — stdio トランスポート、MCP 1.x に対応。Claude Code、Cursor、Claude Desktop、Windsurf、または汎用ホストで利用できます

🔑 API キーを取得する（無料）

無料キーを追加すると、銀行間比較、クロス通貨ペア、公開カレンダーを利用できます。無料で、クレジットカードは不要です。日付指定の（過去の）テーブルと時系列データには有料プランが必要です。無料キーとトライアルキーでは、それらに対して 403 が返されます。

1. allratestoday.com/register で登録します（30 秒）
2. メールアドレスを確認します
3. ダッシュボードからキーをコピーします（形式：art_live_xxxxx）
4. 以下の設定で ALLRATES_API_KEY として使用します

キーがない場合、サーバーはキーなしモードの簡単な概要（以下）を stderr に出力して動作を続けます。MCP サーバーが終了するとホストクライアントの設定全体が機能しなくなるため、終了することはありません。

🔓 キーなしモード — 設定なしで使える機能

設定なしでインストールするだけで、起動して接続し、応答します。

ツール	キーなし	利用できる内容
list_central_banks	✅	パッケージに同梱されたカタログから、対象となるすべての機関（122 の中央銀行、4 つの税務当局と複合機関）を取得できます（対応期間の日付情報はありません）。
get_official_rates	✅	任意のソースの最新の公開テーブル、またはその中の公開済み通貨ペア（もしくはその逆のペア）を取得できます。公開元独自の rate_date が含まれます。クロス通貨ペアにはキーが必要です。
get_official_rates と date を指定	🔑	日付指定のテーブルには有料プランが必要であることを説明する一文が返されます。
get_official_rate_history	🔑	同様です（有料プラン）。
compare_official_rates	🔑	無料キーの取得方法を説明する一文が返されます。
get_publication_calendar	🔑	同様です。
request_trial_key	✅	アカウントなしで 100 回の呼び出しが可能な 7 日間有効のキーを発行し、セッションで使用します。

キーなしの経路では、オープンでエッジキャッシュされた /api/open/central-bank/{bank} エンドポイントを読み取ります（正確な帰属表示の文言は各レスポンスの attribution フィールドにも含まれています）。

帰属表示。 キーなしで利用する場合、レートを表示する場所（フッター、概要ページ、README など）に、AllRatesToday への目立つリンクで、クリック可能なものを掲載する必要があります。API キーを使用する場合、掲載は歓迎されますが、必須ではありません。

<a href="https://allratestoday.com">Exchange rates by AllRatesToday</a>

Markdown：Exchange rates by [AllRatesToday](https://allratestoday.com)。全文：https://allratestoday.com/terms/#attribution。

🧩 最も簡単なインストール方法：Claude Code プラグイン

Claude Code を使用している場合は、このサーバーを手動で設定する代わりにプラグインをインストールしてください。AllRatesToday の MCP サーバー 2 つ、スキル 2 つ、スラッシュコマンド 5 つ（/rate、/convert、/official-rate、/fx-history、/add-currency-support）が含まれています。

/plugin marketplace add AllRates-Today/claude-code-plugin
/plugin install allratestoday@allratestoday

以下の内容は、その他の MCP クライアントにも適用されます。

☁️ ホスト型エンドポイント — インストール不要

同じ 6 つのツールは、同じ AllRatesToday の関連サーバーの 5 つのツールとともに、ホスト型の Streamable HTTP MCP サーバーでも実行できます。ホスト型エンドポイントでは合計 11 個のツールを利用できます（この npm パッケージ自体が公開するのは 6 個です）。リモート MCP に対応する任意のクライアントに URL を貼り付けてください。Claude.ai と Claude Desktop のコネクター、ChatGPT、Cursor、VS Code、Codex、Gemini CLI に対応しています。

https://allratestoday.com/api/mcp

claude mcp add --transport http allratestoday https://allratestoday.com/api/mcp

キーなしで動作します。キーを使用する場合は、Authorization: Bearer art_live_… を送信するか、URL のみを受け付けるクライアントでは https://allratestoday.com/api/mcp?api_key=art_live_… に接続してください。レジストリ名：com.allratestoday/mcp。Cursor / VS Code のワンクリックボタン：https://allratestoday.com/mcp/#hosted

📦 インストール

# 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_xxxxx

Claude 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 を再起動します。

🧰 ツール

ツール	機能	プラン
list_central_banks	対応機関の一覧（コード、メタデータ、最新日付を含む）	無料（キー不要：カタログを同梱）
get_official_rates	銀行が公表した表（または1通貨ペア分）。最新または指定日付のデータ	キー不要（最新）／有料（日付指定）
get_official_rate_history	1通貨ペアの日付ごとの公式レート系列	有料。対象月ごとに約1回分の呼び出しとして課金
compare_official_rates	すべての銀行における1通貨ペアのレートとスプレッド統計	無料（キーが必要）
get_publication_calendar	銀行が実際に公表した日付（値は含まない）	無料（キーが必要）
request_trial_key	アカウント不要で、100回・7日間有効なトライアルキーを自分で発行し、残りのセッションで使用できます	キー不要。IPごとに1日3回まで

🔒 プライバシー

allratestoday.com に送信されるのはリクエストパラメーターと API キーのみです。会話のコンテキストが送信されることはありません。

📚 AllRatesToday のその他の情報

• 中央銀行 REST API ドキュメント
• 銀行ごとの npm SDK
• @allratestoday/mcp-server — リアルタイムのミッドマーケットレートを提供する MCP サーバー
• オープンデータアーカイブ — 同じ公表済みの表を毎日ミラーリングしています：Hugging Face · Kaggle（CC BY-NC 4.0）

🔗 リンク

• API ドキュメント
• 登録（無料）
• ダッシュボード
• ステータス
• Postman コレクション
• GitHub

ライセンス

MIT © AllRatesToday