mcp server

japanfinance-agent

Compound MCP agent combining 6 Japan finance data sources — EDINET, TDNET, e-Stat, BOJ, news, stock prices

ajtgjmdjp/japanfinance-agentcommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

uv (`curl -LsSf https://astral.sh/uv/install.sh | sh`)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "japanfinance-agent": {
      "command": "uvx",
      "args": [
        "japanfinance-agent"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 26, 2026

japanfinance-agent

Status: Maintenance mode — This project is stable and functional but not actively developed. Issues and PRs are welcome.

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:

What you want	Without japanfinance-agent	With japanfinance-agent
Company analysis	3 sequential MCP calls (EDINET → TDNET → stock)	`analyze 7203`
Macro overview	e-Stat search + result aggregation	`macro -k GDP`
Earnings watchlist	N × TDNET calls for N companies	`monitor 7203 6758 6861`

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

Tool	Description
`analyze_japanese_company`	企業の包括分析（EDINET財務 + TDNET開示 + 株価）
`get_macro_snapshot`	マクロ経済スナップショット（e-Stat 政府統計）
`monitor_earnings`	複数企業の決算・開示モニタリング
`check_data_sources`	データソースの接続状況を確認

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

Source	Auth	Data
EDINET	API key (free)	Securities filings, XBRL financial statements
TDNET	None	Timely disclosures (earnings, dividends)
e-Stat	App ID (free)	Government statistics (GDP, CPI, employment)
yfinance	None	Stock prices & market data

License

Apache-2.0