Skip to content
Back to search

edinet-mcp-server

Official KabuMetrics MCP server for Japan stock financials & FSA EDINET filings.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kabumetrics--edinet-mcp-server/badge.svg)](/listings/kabumetrics--edinet-mcp-server)

HTML

<a href="/listings/kabumetrics--edinet-mcp-server"><img src="/api/listings/kabumetrics--edinet-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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"
      }
    }
  }
}

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 101 lines
  1. <!-- mcp-name: io.github.kabumetrics/edinet-mcp-server -->
  2. # KabuMetrics Japan EDINET MCP Server
  3. [日本語ドキュメント (Japanese README)](https://github.com/kabumetrics/edinet-mcp-server/blob/main/README_ja.md) | [Website](https://kabumetrics.com) | [Interactive API Playground](https://kabumetrics.com/playground) | [Live Research Reports](https://kabumetrics.com/reports/)
  4. 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.
  5. 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.
  6. ---
  7. ## Features (14 Tools)
  8. | Category | Tools | What You Can Ask Your AI |
  9. | :--- | :--- | :--- |
  10. | **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. |
  11. | **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. |
  12. | **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. |
  13. | **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.). |
  14. | **Human Capital & ESG** | `get_esg_metrics`, `screen_esg` | Compare statutory average annual salary, female director ratio, male childcare leave uptake, and gender wage parity. |
  15. | **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. |
  16. ---
  17. ## Prerequisites: Free API Key ($0/mo)
  18. This MCP server connects to the **KabuMetrics Japan Stock Financials & Filings API** on RapidAPI.
  19. 1. Subscribe to the **Free Basic Plan ($0/month, no credit card required)** on RapidAPI:
  20. 👉 **[Get Free X-RapidAPI-Key on RapidAPI](https://rapidapi.com/kabumetric-labs-kabumetric-labs-default/api/kabumetrics-japan-stock-financials-filings/pricing)**
  21. 2. Copy your `X-RapidAPI-Key`.
  22. ---
  23. ## Quick Setup
  24. ### Option 1: One-Line Setup via `uvx` (Recommended)
  25. Add the following to your **Claude Desktop** (`claude_desktop_config.json`), **Cursor** (`~/.cursor/mcp.json`), or **Antigravity** MCP configuration:
  26. ```json
  27. {
  28. "mcpServers": {
  29. "kabumetrics-edinet": {
  30. "command": "uvx",
  31. "args": ["kabumetrics-edinet-mcp"],
  32. "env": {
  33. "EDINET_RAPIDAPI_KEY": "YOUR_RAPIDAPI_KEY_HERE"
  34. }
  35. }
  36. }
  37. }
  38. ```
  39. ### Option 2: Standard Python (`pip`)
  40. ```bash
  41. pip install kabumetrics-edinet-mcp
  42. ```
  43. Then configure your MCP client:
  44. ```json
  45. {
  46. "mcpServers": {
  47. "kabumetrics-edinet": {
  48. "command": "kabumetrics-edinet-mcp",
  49. "env": {
  50. "EDINET_RAPIDAPI_KEY": "YOUR_RAPIDAPI_KEY_HERE"
  51. }
  52. }
  53. }
  54. }
  55. ```
  56. ---
  57. ## Example Prompts
  58. - *"Compare Toyota (7203) and Honda (7267) 10-year revenue, operating margin, and ROE from official EDINET filings."*
  59. - *"Which Japanese listed companies have Hikari Tsushin or National Indemnity in their Top 10 major shareholders?"*
  60. - *"Summarize the key business risks and US tariff mentions in Nintendo's (7974) latest annual securities report."*
  61. - *"Show me the latest 5% Rule activist filings in Japan and their stated holding purposes."*
  62. - *"Rank the top 15 Japanese companies in Information & Communication by average annual salary and female director ratio."*
  63. ---
  64. ## Live Examples & Resources
  65. - **Official Website:** https://kabumetrics.com
  66. - **Interactive API Playground (No code required):** https://kabumetrics.com/playground
  67. - **Curated EDINET Research Reports & YoY Filing Diffs:** https://kabumetrics.com/reports/
  68. ## Disclaimer
  69. 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.
  70. ## License
  71. MIT License — see [LICENSE](https://github.com/kabumetrics/edinet-mcp-server/blob/main/LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.