japanfinance-agent

Compound MCP agent that combines Japan finance data sources into high-value analysis tools. Instead of calling each source individually, get comprehensive company analysis, macro snapshots, and earnings monitoring in a single request.

Part of the Japan Finance Data Stack: edinet-mcp (securities filings) | tdnet-disclosure-mcp (timely disclosures) | estat-mcp (government statistics) | stockprice-mcp (stock prices)

Why?

Each Japan finance MCP provides focused data from one source. But real analysis needs multiple sources combined:

Installation

# Core only (brings no data sources)
pip install japanfinance-agent

# With all data sources
pip install "japanfinance-agent[all]"

# Pick specific sources
pip install "japanfinance-agent[edinet,tdnet,news]"

Available extras: edinet, tdnet, estat, stock, all

Configuration

Add to Claude Desktop config:

{
  "mcpServers": {
    "japanfinance": {
      "command": "uvx",
      "args": ["japanfinance-agent[all]", "serve"],
      "env": {
        "EDINET_API_KEY": "your_edinet_key",
        "ESTAT_APP_ID": "your_estat_app_id"
      }
    }
  }
}

Then ask: "トヨタの財務分析をして" or "日本のGDP関連の最新データを見せて"

MCP Tools

CLI Usage

# Analyze a company (EDINET + TDNET + stock)
japanfinance-agent analyze 7203
japanfinance-agent analyze 7203 -e E02144 -p 2025 --json-output

# Macro economic snapshot (e-Stat)
japanfinance-agent macro
japanfinance-agent macro -k CPI

# Monitor earnings for a watchlist
japanfinance-agent monitor 7203 6758 6861

# Check which data sources are available
japanfinance-agent test

# Start MCP server
japanfinance-agent serve

Architecture

japanfinance-agent
├── analyze_company(code)     → EDINET + TDNET + stock (parallel)
├── macro_snapshot(keyword)   → e-Stat government statistics
├── earnings_monitor(codes[]) → TDNET × N companies (parallel)
└── check_data_sources()      → connectivity status

Adapters (graceful degradation — missing packages return empty results):
├── edinet-mcp    → Financial statements, metrics, company search
├── tdnet-mcp     → Timely disclosures (earnings, dividends, buybacks)
├── estat-mcp     → Government statistics (GDP, CPI, employment)
└── stockprice-mcp → Stock prices & FX (via yfinance)

Data Sources

License

Apache-2.0