Edinet MCP server
io.github.ajtgjmdjp/edinet-mcp·v0.4.1·18 starsAccess Japanese financial disclosures (EDINET). Search companies, retrieve BS/PL/CF statements.
18 stars
Reviews
Write oneNobody has reviewed Edinet yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Edinet tools (11)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
compare_financial_periodsCompare financial data between current and previous periods.
diff_financial_statementsCompare financial statements for the same company across two periods.
get_company_infoGet detailed information about a company by EDINET code.
get_filingsList financial filings for a company within a date range.
get_financial_metricsCalculate key financial metrics (ROE, ROA, profit margins, etc.).
get_financial_statementsRetrieve and parse financial statements (BS, PL, CF) for a company.
get_narrativeGet a qualitative narrative section from a company's annual report.
get_receiptsGet machine-verifiable evidence receipts for key financial figures.
list_available_labelsList all available financial line item labels for a statement type.
screen_companiesCompare financial metrics across multiple companies.
search_companiesSearch for Japanese companies registered in EDINET.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan22 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 1 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Edinet compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 70% of 3,470 Web search servers
- Tools
- 11
- the typical Web search server has 5
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 18
- more than 88% of 1,786 Web search servers
What its tools let an agent do: 11 read
Install Edinet in Claude Code, Cursor or VS Code
claude mcp add edinet-mcp -- uvx edinet-mcp
What the publisher says
From the Edinet repository's README, as published. We do not edit it. Read it on GitHub
edinet-mcp
EDINET XBRL parsing library and MCP server for Japanese financial data.
日本語版READMEはこちら
📝 日本語チュートリアル: Claude に聞くだけで上場企業の決算がわかる (Zenn)
Part of the Japan Finance Data Stack: edinet-mcp (securities filings) | tdnet-disclosure-mcp (timely disclosures) | estat-mcp (government statistics) | stockprice-mcp (stock prices & FX)
Building a high-throughput pipeline, batch-parsing thousands of filings, or
need SEC EDGAR coverage too? See xbrl-facts
— a Rust iXBRL engine for SEC + EDINET with byte-range provenance.
What it looks like
<!-- TODO: replace with a short GIF of a real Claude Desktop session -->
Ask your AI assistant (with edinet-mcp connected):
You: トヨタの最新の決算と、会社が挙げている主要なリスクを教えて
Claude: トヨタ自動車 (E02144) の有価証券報告書(2026年6月10日提出)によると——
- 売上高: 50.7兆円(前期 48.0兆円、約 +5.5%)
- 事業等のリスク(有報本文より): 自動車市場の競争激化 — CASE などの技術革新が進むことで競争は一層激化し、業界再編につながる可能性も指摘 …
Every number and passage above is fetched from the actual EDINET filing via getfinancialstatements / get_narrative — nothing comes from the model's memory.
What is this?
edinet-mcp provides programmatic access to Japan's EDINET financial disclosure system. It normalizes XBRL filings across accounting standards (J-GAAP / IFRS / US-GAAP) into canonical Japanese labels and exposes them as an MCP server for AI assistants.
- Search 5,000+ listed Japanese companies
- Retrieve annual/quarterly/semiannual reports (有価証券報告書, 四半期報告書, 半期報告書) plus extraordinary (臨時報告書) and large shareholding (大量保有報告書) filings
- Automatic normalization: stmt["売上高"] works regardless of accounting standard
- Bilingual labels: stmt["Revenue"] works too (case-insensitive), and the MCP tool supports language='en' for fully English output
- Financial metrics (ROE, ROA, profit margins) and year-over-year comparisons
- Parse XBRL into Polars/pandas DataFrames (BS, PL, CF)
- Multi-company screening: Compare financial metrics across up to 20 companies
- Cross-period diff (xbrl-diff): Compare financial statements across periods with change amounts (増減額) and growth rates (増減率)
- Narrative sections: extract 事業等のリスク, MD&A, 経営方針 and more as plain text (get_narrative)
- Evidence receipts (optional): machine-verifiable claim-to-source records for key figures, backed by the xbrl-facts Rust engine (get_receipts, pip install edinet-mcp[receipts])
- MCP server with 11 tools for Claude Desktop and other AI tools
Why edinet-mcp?
Unlike commercial EDINET data APIs, edinet-mcp is fully free and local: the XBRL parser runs on your machine, the only credential you need is a free EDINET API key from the FSA, and every number is traceable to the original filing. No paid tiers, no usage caps beyond EDINET's own rate limits, Apache-2.0 licensed.
Quick Start
Installation
pip install edinet-mcp
# or
uv add edinet-mcpShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Edinet: common questions
- Is Edinet MCP server safe?
- Mostly: it is graded B (83/100). Read the Edinet safety report
- How do I install Edinet?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Edinet need an API key?
- Yes. The registry entry asks for
EDINET_API_KEY. - Is Edinet maintained?
- The last commit was 37 days ago (2026-09-28). The latest release is v0.4.1.
- What can I use instead of Edinet?
- Servers from other publishers that do the same job: Jobseek MCP server and Workopia — Job Search MCP server.
- How does Edinet compare with other Web search MCP servers?
- safety score 83/100 (higher than 70% of 3,470 Web search servers); tools 11 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Edinet
Same job from other publishers: the closest match first, then the best rated.
- JobseekSearch jobs and companies on Job Seek (jseek.co)not reviewedEstablishedA
- Workopia — Job SearchSearch 6.3M+ live jobs from companies' own career pages, plus resume tailoring & cover letters.not reviewedGrowingB