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: 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 installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityAmaintenanceProvides 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.16Apache 2.0
- Alicense-qualityCmaintenanceEnables 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.MIT
- Flicense-qualityDmaintenanceA multi-agent MCP server for comprehensive stock research and analysis using natural language queries, backed by SEC filings and real-time market data.
- 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.418MIT
Related MCP Connectors
The financial MCP for AI agents - 90+ financial tables, SEC filings, signals, alt-data.
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
Remote MCP for Japan's EDINET DB — 3,800 listed companies' financials & filings (OAuth)
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- 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