Boj Mcp

Access Bank of Japan (BOJ/日本銀行) statistical data — price indices (CGPI, SPPI), flow of funds, balance of payments, BIS statistics, interest rates, money supp...

Security Scan

The skill's declared purpose (access BOJ statistical flat files) matches its instructions and required artifacts; it installs/uses a dedicated boj-mcp binary and does not ask for unrelated credentials or elevated privileges.

Purpose & Capability

Name/description, runtime commands in SKILL.md, and the required binary (boj-mcp) are consistent: the skill is a thin wrapper around a client that downloads BOJ flat files. No unrelated credentials, tools, or paths are requested.

Instruction Scope

SKILL.md instructs only to run the boj-mcp CLI to list/search/download BOJ datasets and to test connectivity. It notes local caching and character encoding handling — both reasonable for this use case. The instructions do not ask the agent to read unrelated files, secrets, or to transmit data to third-party endpoints.

Install Mechanism

Install spec uses a third-party package installer ('uv' package kind) that will create a binary named boj-mcp; SKILL.md also suggests 'pip install boj-mcp' as an alternative. Installing third-party packages executes external code, which is expected for a CLI client but carries normal supply-chain risk. Verify package provenance (registry, checksums) before installing.

Credentials

No environment variables, credentials, or config paths are required. The skill does local caching but does not request secrets or access to unrelated services — this is proportionate to its stated purpose.

Persistence & Privilege

always is false and the skill does not request any elevated or persistent platform-wide privileges. Local caching is normal for a data client and the skill does not attempt to modify other skills or system-wide agent configs.

Assessment

This skill appears coherent: it is a CLI client for publicly available BOJ flat files and does not request secrets. Before installing, verify the boj-mcp package source (PyPI or the uv registry), check package maintainers and release checksums, and consider installing in a sandbox or virtual environment if you have supply-chain concerns. If you need maximum assurance, review the package source code (or request a package provenance URL) prior to installation.

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

1. boj-mcp datasets -> browse available datasets
2. boj-mcp search <keyword> -> find relevant series
3. boj-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-mcp or uv tool install boj-mcp