boj-jstat-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@boj-jstat-mcp get the dollar-yen exchange rate for December 2025"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
boj-jstat-mcp
日本銀行 時系列統計データ検索サイトのAPI機能を利用するMCP(Model Context Protocol)サーバーです。
金利、マネーサプライ、為替レート、短観、国際収支、物価指数など、40以上の日銀統計データベースにClaude/CodexなどのAIアシスタントから直接アクセスできます。
クイックスタート
git clone なしでそのまま使えます。npx -y boj-jstat-mcp@latest を指定すると npm から取得して起動できます。
注意(2026-02-25時点):
boj-mcp@latestは別プロジェクト(solved.ac向け)であり、このリポジトリの日銀MCPではありません。
Claude Desktop
claude_desktop_config.json に以下を追加:
{
"mcpServers": {
"boj": {
"command": "npx",
"args": ["-y", "boj-jstat-mcp@latest"]
}
}
}Claude Code
追加:
claude mcp add boj -- npx -y boj-jstat-mcp@latest確認:
claude mcp list削除:
claude mcp remove bojCodex CLI
追加:
codex mcp add boj -- npx -y boj-jstat-mcp@latest確認:
codex mcp list
codex mcp get boj削除:
codex mcp remove bojRelated MCP server: jquants-mcp
使い方(推奨フロー)
boj_list_databasesでDB候補を絞るboj_get_metadataをlimit=20-50程度で呼び、系列コード/レイヤーを特定boj_get_data_codeまたはboj_get_data_layerで本取得NEXTPOSITIONが返ったらstartPositionでページング
使用例
物価関連のDBを探す:
「物価に関する日銀のデータベースを一覧表示して」
短観DIデータを取得:
「2024年第1四半期から2025年第4四半期までの短観・大企業製造業の業況判断DIを取得して」
為替レートを確認:
「2025年12月のドル円為替レートデータを見せて」
国際収支を参照:
「2025年1月の国際収支統計から経常収支を取得して」
アクセス可能なデータベース一覧
1. 金利(預金・貸出関連)
DBコード | 説明 |
IR01 | 基準割引率および基準貸付利率(従来「公定歩合」として掲載されていたもの)の推移 |
IR02 | 預金種類別店頭表示金利の平均年利率等 |
IR03 | 定期預金の預入期間別平均金利 |
IR04 | 貸出約定平均金利 |
2. マーケット関連
DBコード | 説明 |
FM01 | 無担保コールO/N物レート(毎営業日) |
FM02 | 短期金融市場金利 |
FM03 | 短期金融市場残高 |
FM04 | コール市場残高 |
FM05 | 公社債発行・償還および現存額 |
FM06 | 公社債消化状況(利付国債) |
FM07 | (参考)国債窓口販売額・窓口販売率(2004年1月まで) |
FM08 | 外国為替市況 |
FM09 | 実効為替レート |
3. 決済関連
DBコード | 説明 |
PS01 | 各種決済 |
PS02 | フェイルの発生状況 |
4. 預金・マネー・貸出
DBコード | 説明 |
MD01 | マネタリーベース |
MD02 | マネーストック |
MD03 | マネタリーサーベイ |
MD04 | (参考)マネーサプライ(M2+CD)増減と信用面の対応 |
MD05 | 通貨流通高 |
MD06 | 日銀当座預金増減要因と金融調節(実績) |
MD07 | 準備預金額 |
MD08 | 業態別の日銀当座預金残高 |
MD09 | マネタリーベースと日本銀行の取引 |
MD10 | 預金者別預金 |
MD11 | 預金・現金・貸出金 |
MD12 | 都道府県別預金・現金・貸出金 |
MD13 | 貸出・預金動向 |
MD14 | 定期預金の残高および新規受入高 |
LA01 | 貸出先別貸出金 |
LA02 | 日本銀行貸出 |
LA03 | その他貸出残高 |
LA04 | コミットメントライン契約額、利用額 |
LA05 | 主要銀行貸出動向アンケート調査 |
5. 金融機関バランスシート
DBコード | 説明 |
BS01 | 日本銀行勘定 |
BS02 | 民間金融機関の資産・負債 |
6. 資金循環
DBコード | 説明 |
FF | 資金循環 |
7. その他の日本銀行関連
DBコード | 説明 |
OB01 | 日本銀行の対政府取引 |
OB02 | 日本銀行が受入れている担保の残高 |
8. 短観
DBコード | 説明 |
CO | 短観 |
9. 物価
DBコード | 説明 |
PR01 | 企業物価指数 |
PR02 | 企業向けサービス価格指数 |
PR03 | 製造業部門別投入・産出物価指数 |
PR04 | <サテライト指数>最終需要・中間需要物価指数 |
10. 財政関連
DBコード | 説明 |
PF01 | 財政資金収支 |
PF02 | 政府債務 |
11. 国際収支・BIS関連
DBコード | 説明 |
BP01 | 国際収支統計 |
BIS | BIS国際資金取引統計および国際与信統計の日本分集計結果 |
DER | デリバティブ取引に関する定例市場報告 |
12. その他
DBコード | 説明 |
OT | その他 |
ツール一覧
boj_list_databases — DB一覧表示
利用可能な日銀統計データベースの一覧を表示します。APIコール不要(静的データ)。
パラメータ | 必須 | 説明 |
| いいえ | カテゴリでフィルタ |
| いいえ | コードまたは名前で検索 |
boj_get_metadata — メタデータ取得
データベースのメタデータ(系列コード、名称、単位、期種、階層構造)を取得します。
返却には SERIES_CODE を持つ行のみを表示し、boj_get_data_code で使えない見出し行は除外します。
パラメータ | 必須 | 説明 |
| はい | DBコード(例: |
| いいえ |
|
| いいえ | 返却件数上限(デフォルト200、最大1000) |
boj_get_data_code — 系列コード指定データ取得
系列コードを指定して時系列データを取得します。1リクエストあたり最大250系列/60,000データポイント。
code は必ず boj_get_metadata で取得した SERIES_CODE をそのまま指定してください(DB接頭辞や引用符区切りの旧形式は不可)。無効コード時は近い候補を提示し、近似一致が十分高い場合は自動補正して再試行します。
パラメータ | 必須 | 説明 |
| はい | DBコード |
| はい | カンマ区切りの系列コード(同一期種のみ) |
| いいえ |
|
| いいえ | 開始期(形式は期種に依存) |
| いいえ | 終了期 |
| いいえ | ページネーション(前回のNEXTPOSITION値) |
boj_get_data_layer — 階層指定データ取得
階層構造を指定して時系列データを取得します。ワイルドカード * 対応。最大1,250系列/60,000データポイント。
パラメータ | 必須 | 説明 |
| はい | DBコード |
| はい | カンマ区切りの階層値(例: |
| はい |
|
| いいえ |
|
| いいえ | 開始期 |
| いいえ | 終了期 |
| いいえ | ページネーション(前回のNEXTPOSITION値) |
日付パラメータの仕様(重要)
BOJ API の仕様上、
startDate/endDateは期種単位の指定です。YYYY-MM-DDとYYYYMMDDを渡した場合、サーバー側で期種フォーマットへ正規化します。D(日次)/W(週次)系列でも、BOJ API にはYYYYMM形式で問い合わせます(返却データ自体は日付単位)。
レート制限
BOJの「高頻度アクセスは避けてください」というガイドラインに準拠するため、トークンバケット方式のレートリミッター(容量5、毎秒1トークン補充)を内蔵しています。並列リクエスト時も内部キューで制御し、過剰送信を防ぎます。
動作要件
Node.js 18.0.0以上
クレジット
このサービスは、日本銀行時系列統計データ検索サイトの API 機能を使用しています。サービスの内容は日本銀行によって保証されたものではありません。
Available Tools
4 toolsboj_get_data_codeA
Fetch time series data by SERIES_CODE(s). All specified codes must share the same frequency. Returns up to 250 series / 60,000 data points per request. If a code is invalid, the server tries metadata-assisted correction for close matches and returns concrete suggestions.
Inputs: db (required), code (required), lang, endDate, +2 more.
boj_get_data_layerA
Fetch time series data by layer (hierarchical structure). Useful for browsing data by category within a database. Supports wildcard '*'. Returns up to 1,250 series / 60,000 data points per request.
Inputs: db (required), layer (required), frequency (required), lang, +3 more.
boj_get_metadataA
Get metadata (series codes, names, units, frequencies, layer structure) for a BOJ database. Use this to discover available series codes and understand the database structure before fetching actual data. NOTE: Large databases like CO (Tankan, 168k series) require a small limit (e.g. 20-50) to avoid overwhelming responses — use layer-based queries to navigate them.
Inputs: db (required), lang, limit.
boj_list_databasesA
List all available BOJ statistical databases. Use this first to find the correct DB code before querying data. No API call needed — uses a static list of 40+ databases.
Inputs: search, category.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: listing databases, fetching data by code, fetching data by layer, and retrieving metadata. There is no overlap or ambiguity.
All tools follow a consistent 'boj_verb_object' pattern (e.g., boj_list_databases, boj_get_data_code), making it easy for agents to predict function.
Four tools is well-scoped for a statistical data server, covering essential operations without redundancy or bloat.
The tool set covers the full workflow: discover databases, explore metadata, and retrieve data via two complementary methods (by code and by layer). No obvious gaps.
Maintenance
Related MCP Connectors
TradeStats serves official customs trade statistics (Japan: Ministry of Finance; UK: HMRC) as an MCP server and a web API, built for AI agents. Monthly imports and exports by HS code and partner country, with unit prices, year-on-year changes, price/volume decomposition, supplier concentration, seasonality, mirror trade checks and US-dollar conversion. Search products in English or Japanese. No account needed; a free API key is optional.
MCP server for AI dialogue using various LLM models via AceDataCloud
Hosted MCP server for live public-data APIs and Skills for AI agents.
This MCP server provides seamless access to Malaysia's government open data, including datasets, w…
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceMCP server for Japan's e-Stat (Government Statistics Portal). Search statistical datasets, retrieve data tables, and access metadata from official Japanese government statistics.55 PyPI10Apache 2.0
- AlicenseAqualityBmaintenanceAn MCP server that retrieves Japanese stock market data via J-Quants API v2.55144 PyPI3MIT
- AlicenseBqualityDmaintenanceMCP server for accessing Japanese government statistics portal 'e-Stat' API, enabling language models to search and retrieve statistical data.597 PyPI21MIT
- AlicenseAqualityDmaintenanceMCP server providing official US economic data including CPI inflation, famous prices, national debt, and Treasury interest rates. Enables AI agents to query historical and latest economic statistics via natural language.850 npmMIT