KabuMetrics Japan EDINET MCP Server
日本語ドキュメント (Japanese README) | Website | Interactive API Playground | Live Research Reports
An official Model Context Protocol (MCP) server connecting Claude Desktop, Cursor, Windsurf, Antigravity, and any MCP-compatible AI agent to official Japan FSA EDINET statutory filings across 4,000+ Tokyo Stock Exchange listed companies.
Query 10-year standardized financials, Top-10 major shareholders (reverse lookup), 5% Rule activist & institutional filings, statutory Human Capital / ESG metrics, and full-text Japanese Annual Securities Reports (Yukashoken Hokokusho / 有価証券報告書) directly from your AI assistant.
Features (15 Tools)
| Category | Tools | What You Can Ask Your AI |
|---|---|---|
| Companies & Sectors | list_industries, search_companies, get_company_profile |
Look up any TSE ticker (7203, 6758, 285A), English/Japanese company name, or TSE 33-sector industry. |
| 10-Year Financials | get_financials, screen_financials |
Retrieve standardized Revenue, Operating Income, Net Income, ROE, ROA, Cash Flows, Capex, R&D, EPS, DPS, DOE, or screen by ROE/revenue/industry. |
| Major Shareholders (Top 10) | get_major_shareholders, screen_shareholders |
Reverse-lookup all Japanese stocks where Berkshire Hathaway (National Indemnity), Hikari Tsushin, or Nippon Life appear in the Top 10 shareholders. |
| 5% Rule / Activists | get_large_shareholdings, get_recent_large_shareholdings |
Track activist & institutional 5% Rule filings and stake changes (3D Investment, Oasis, BlackRock, Effissimo, etc.). |
| Human Capital & ESG | get_esg_metrics, screen_esg |
Compare statutory average annual salary, female director ratio, male childcare leave uptake, and gender wage parity. |
| Annual Report Full Text | get_report_section, get_report_full_text, search_reports |
Read clean Markdown sections (risks, strategy, mda, governance, remuneration, sustainability, rd_activities) or full-text search across 10 years of filings. |
Prerequisites: Free API Key ($0/mo)
This MCP server connects to the KabuMetrics Japan Stock Financials & Filings API on RapidAPI.
- Subscribe to the Free Basic Plan ($0/month, no credit card required) on RapidAPI:
👉 Get Free X-RapidAPI-Key on RapidAPI - Copy your
X-RapidAPI-Key.
Quick Setup
Option 1: One-Line Setup via uvx (Recommended)
Add the following to your Claude Desktop (claude_desktop_config.json), Cursor (~/.cursor/mcp.json), or Antigravity MCP configuration:
{
"mcpServers": {
"kabumetrics-edinet": {
"command": "uvx",
"args": ["kabumetrics-edinet-mcp"],
"env": {
"EDINET_RAPIDAPI_KEY": "YOUR_RAPIDAPI_KEY_HERE"
}
}
}
}
Option 2: Standard Python (pip)
pip install kabumetrics-edinet-mcp
Then configure your MCP client:
{
"mcpServers": {
"kabumetrics-edinet": {
"command": "kabumetrics-edinet-mcp",
"env": {
"EDINET_RAPIDAPI_KEY": "YOUR_RAPIDAPI_KEY_HERE"
}
}
}
}
Example Prompts
- "Compare Toyota (7203) and Honda (7267) 10-year revenue, operating margin, and ROE from official EDINET filings."
- "Which Japanese listed companies have Hikari Tsushin or National Indemnity in their Top 10 major shareholders?"
- "Summarize the key business risks and US tariff mentions in Nintendo's (7974) latest annual securities report."
- "Show me the latest 5% Rule activist filings in Japan and their stated holding purposes."
- "Rank the top 15 Japanese companies in Information & Communication by average annual salary and female director ratio."
Live Examples & Resources
- Official Website: https://kabumetrics.com
- Interactive API Playground (No code required): https://kabumetrics.com/playground
- Curated EDINET Research Reports & YoY Filing Diffs: https://kabumetrics.com/reports/
Disclaimer
Data is automatically parsed from public Japan FSA EDINET statutory filings for informational and research purposes only. Nothing provided by this server constitutes investment advice or solicitation. Always verify critical information against official filings.
License
MIT License — see LICENSE.
Metadata
Release files for kabumetrics-edinet-mcp 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| kabumetrics_edinet_mcp-1.0.1.tar.gz | 7.5 kB | Without provenance | Details for kabumetrics_edinet_mcp-1.0.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| kabumetrics_edinet_mcp-1.0.1-py3-none-any.whl | Python 3 | none | any | Details for kabumetrics_edinet_mcp-1.0.1-py3-none-any.whl |
Total release size: 15.8 kB
Release files / kabumetrics_edinet_mcp-1.0.1.tar.gz
| Download URL | kabumetrics_edinet_mcp-1.0.1.tar.gz |
|---|---|
| Size | 7.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a08ffef10b7284a3c8248ced3814c53b5a8699ccc5c77d442930f314e1d2514c
|
|
BLAKE2b-256 checksum How to use checksums |
ad406f1a0b412a95f4f01117292b573bada2424d750ab1c222424fb41726cd1b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.10
|
Release files / kabumetrics_edinet_mcp-1.0.1-py3-none-any.whl
| Download URL | kabumetrics_edinet_mcp-1.0.1-py3-none-any.whl |
|---|---|
| Size | 8.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7ce804fc20eb2ba85edaa6c407db6ff83c22ef2790b24c902230ae5c76d898ab
|
|
BLAKE2b-256 checksum How to use checksums |
312483bcffe5832c5cab242d66fda305e43cbfc36f98d267e571076da4b1f012
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.10
|
Security for kabumetrics-edinet-mcp 1.0.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.