japanfinance-agent
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., "@japanfinance-agentanalyze Toyota"
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.
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) |
|
Macro overview | e-Stat search + result aggregation |
|
Earnings watchlist | N × TDNET calls for N companies |
|
Related MCP server: edinet-mcp
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 |
| 企業の包括分析(EDINET財務 + TDNET開示 + 株価) |
| マクロ経済スナップショット(e-Stat 政府統計) |
| 複数企業の決算・開示モニタリング |
| データソースの接続状況を確認 |
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 serveArchitecture
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 |
API key (free) | Securities filings, XBRL financial statements | |
None | Timely disclosures (earnings, dividends) | |
App ID (free) | Government statistics (GDP, CPI, employment) | |
None | Stock prices & market data |
License
Apache-2.0
This server cannot be deployed
Maintenance
Related MCP Connectors
Your agent needs company financials it can compute on — statements, ratios, earnings, estimates, filings and insider activity as structured data, not a PDF. **What you can ask for** • "Give me 8 quarters of income statement, balance sheet and cash flow for this ticker." • "What do analysts estimate for next quarter, and how did the last four surprise?" • "Find this exact line item across every filing." • "Who bought or sold as an insider in the last 90 days?" • "Screen for profitable companies under this valuation with growing revenue." **How to use it** Point any MCP client at https://mcp.aisa.one/marketpulse/mcp and sign in with OAuth — there is no key to create or paste. 21 tools: prices and snapshots, income statements, balance sheets, cash-flow statements, financial metrics and snapshots, earnings, analyst estimates, company facts, filings and filing items, line-item search, a screener, insider trades, macro interest rates, news, plus EDINET documents and filing digests for Japanese issuers. **Why this rather than the source** Statements as fields you can compute on, and a screener in the same place. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the fundamentals here, then ask the same agent what social is saying about the ticker — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/finance/mcp for equities, crypto and prediction markets in one place.
Your agent needs markets — prices and fundamentals for listed companies, the filings behind them, crypto, and what the prediction markets put the odds at. **What you can ask for** • "Pull this company's income statement, cash flow and balance sheet for the last 8 quarters." • "What did insiders buy or sell, and when?" • "Snapshot prices for these 50 tickers, then the OHLC history for the three that moved." • "What are the current odds on this event across Kalshi and Polymarket?" • "Screen for companies matching these financial criteria." **How to use it** Point any MCP client at https://mcp.aisa.one/finance/mcp and sign in with OAuth — there is no key to create or paste. 49 tools: prices and snapshots, income statements, balance sheets and cash flows, metrics and ratios, earnings and analyst estimates, filings and line-item search, insider trades, macro interest rates, news, a screener; CoinGecko spot prices, market tables, OHLC, per-venue tickers and trending; Kalshi and Polymarket markets and trades; plus EDINET filings for Japan. **Why this rather than the source** Equities, crypto and event markets behind one account, so a cross-asset question is one conversation. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Read the number here, then ask the same agent what X is saying about the ticker today — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/marketpulse/mcp · /crypto-market-data/mcp · /prediction-market-data/mcp · /stock-pulse/mcp for one slice each.
Search Japanese subsidies and public company data using J-Grants, gBizINFO, and EDINET.
Search Japanese company credit, financials, subsidies, and procurement via AI agents.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceProvides programmatic access to Japan's EDINET system to search for listed companies and retrieve annual or quarterly financial reports. It parses XBRL filings into structured data, enabling AI assistants to analyze balance sheets, income statements, and cash flows.173 PyPI18Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables access and analysis of Japanese corporate financial data (PL/BS/CF) via EDINET API. Supports searching companies, listing reports, and comparing financials through natural language queries.1MIT
- AlicenseAqualityBmaintenanceLets AI assistants query normalized financial statements (P/L, B/S, C/F) of 3,634 Japanese listed companies from official EDINET filings, unified across J-GAAP, IFRS, and US GAAP with English keys. Zero setup: npx -y edinet-mcp.49 npmMIT
- FlicenseNot gradedqualityDmaintenanceProvides AI agents with comprehensive Japanese market intelligence through 27 MCP tools, covering corporate data, macroeconomics, financials, and environmental data from 14 integrated sources.-