Metadata-Version: 2.4
Name: kabumetrics-edinet-mcp
Version: 1.0.1
Summary: Official Model Context Protocol (MCP) server for KabuMetrics Japan Stock Financials & FSA EDINET Filings API
Author: KabuMetrics
License-Expression: MIT
Project-URL: Homepage, https://kabumetrics.com
Project-URL: Repository, https://github.com/kabumetrics/edinet-mcp-server
Project-URL: Documentation, https://kabumetrics.com/playground
Project-URL: API Keys (Free Tier), https://rapidapi.com/kabumetric-labs-kabumetric-labs-default/api/kabumetrics-japan-stock-financials-filings/pricing
Keywords: mcp,japan-stocks,edinet,japanese-equities,financial-data,shareholders,activist-investing,esg,tokyo-stock-exchange
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp<2.0.0,>=1.2.0
Requires-Dist: httpx>=0.27.0
Dynamic: license-file

<!-- mcp-name: io.github.kabumetrics/edinet-mcp-server -->

# KabuMetrics Japan EDINET MCP Server

[日本語ドキュメント (Japanese README)](./README_ja.md) | [Website](https://kabumetrics.com) | [Interactive API Playground](https://kabumetrics.com/playground) | [Live Research Reports](https://kabumetrics.com/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.

1. Subscribe to the **Free Basic Plan ($0/month, no credit card required)** on RapidAPI:  
   👉 **[Get Free X-RapidAPI-Key on RapidAPI](https://rapidapi.com/kabumetric-labs-kabumetric-labs-default/api/kabumetrics-japan-stock-financials-filings/pricing)**
2. 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:

```json
{
  "mcpServers": {
    "kabumetrics-edinet": {
      "command": "uvx",
      "args": ["kabumetrics-edinet-mcp"],
      "env": {
        "EDINET_RAPIDAPI_KEY": "YOUR_RAPIDAPI_KEY_HERE"
      }
    }
  }
}
```

### Option 2: Standard Python (`pip`)

```bash
pip install kabumetrics-edinet-mcp
```

Then configure your MCP client:

```json
{
  "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](./LICENSE).
