japanfinance-agent
Click on "Install 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: Sibyl
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 installed
Maintenance
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/ajtgjmdjp/japanfinance-agent'
If you have feedback or need assistance with the MCP directory API, please join our Discord server