modbender BOJ: Bank of Japan Statistical Data
Access Bank of Japan time-series statistics from the official flat file download service. Covers price indices (CGPI, SPPI), flow of funds, balance of payments, international investment position, BIS statistics, and TANKAN survey data.
Use Cases
- Look up Corporate Goods Price Index (CGPI/企業物価指数) trends
- Analyze Services Producer Price Index (SPPI/企業向けサービス価格指数)
- Retrieve Flow of Funds data (資金循環統計)
- Access Balance of Payments statistics (国際収支統計)
- Review BIS international statistics
- Explore TANKAN survey results (短観)
Commands
List available datasets
# Show all available BOJ flat file datasets
boj-mcp datasets
Download and display data
# Display dataset in table format
boj-mcp data cgpi_m_en
# JSON output with more rows
boj-mcp data sppi_m_en --format json --rows 50
Search for series
# Search within a specific dataset
boj-mcp search "electricity" --dataset cgpi_m_en
# Search across datasets by name
boj-mcp search "price"
Test connectivity
boj-mcp test
Available Dataset Categories
| Category | Prefix | Description |
|---|---|---|
| Prices | cgpi, sppi, cspi, rop | Corporate/Services price indices |
| Surveys | co | TANKAN (Short-term Economic Survey) |
| Flow of Funds | fof | Financial assets & liabilities |
| Balance of Payments | bp | International transactions |
| International Investment | qiip | International investment position |
| BIS Statistics | bis | BIS international banking/debt |
| Money Stock | md | Money stock statistics |
| Interest Rates | ir | Various interest rates |
Workflow
boj-mcp datasets-> browse available datasetsboj-mcp search <keyword>-> find relevant seriesboj-mcp data <dataset_name>-> retrieve data
Important
- No API key required — BOJ flat files are publicly available
- Data is cached locally after first download for faster subsequent access
- Files are in Shift_JIS encoding (handled automatically)
- Data source: Bank of Japan (https://www.stat-search.boj.or.jp/)
- Python package:
pip install boj-mcporuv tool install boj-mcp