EDINET DB MCP Server
This server provides MCP access to structured financial and corporate data for Japanese listed companies via 13 core tools.
Search & identify companies — resolve Japanese/English names, EDINET codes, or securities codes with
search_companies.Company profiles & financials — pull full profiles and multi-year financial statements (
get_company,get_financials).Segment & earnings analysis — see business-segment profitability and quarterly earnings releases with forecasts (
get_segments,get_earnings).Filings & disclosures — list regulatory filings and read narrative sections like business overview, risks, and MD&A (
get_disclosures,get_text_blocks).Governance & ownership — examine board directors, large shareholders, and reverse-lookup an investor's holdings (
get_directors,get_shareholders,search_shareholders).Market screening & rankings — filter the listed-company universe by numeric criteria, generate league tables, and benchmark against industry peers (
screen_companies,get_ranking,compare_peers).
Provides access to Wikidata as a public open-data source for corporate and entity information, enriching company profiles and knowledge-graph data with Wikidata-backed records.
EDINET DB MCP Server
Remote MCP server for Japan's EDINET DB — structured financial data for ~3,800 Japanese listed companies, served over HTTPS with OAuth 2.0 multi-tenant authentication.
🌐 Endpoint:
https://edinetdb.jp/mcp🔐 Auth: OAuth 2.0 (or API key)
👥 Users: 9,000+ registered developers, analysts, and academic researchers
📅 Production since: 2026-03-01
🇯🇵 First remote MCP service for Japanese listed-company filings (by author's research as of 2026-02 month-end)
What it does
EDINET DB exposes structured financial and corporate data extracted from Japan's regulatory filings (EDINET, by the Financial Services Agency) plus public open data (gBizINFO from METI, National Tax Agency corporate registry, Wikidata). Connect from Claude Desktop, Claude Code, Cursor, Codex CLI, or any MCP-compatible client to query company financials, HR/diversity disclosures, supply chains, patents, executive profiles, and corporate history via natural language.
Related MCP server: edinet-mcp
Two ways to connect
Remote (recommended) | Local stdio server (this repo) | |
Endpoint |
| runs on your machine |
Tools | 75 | 13 core tools |
Auth | OAuth 2.0 or API key | API key ( |
Setup | add one URL |
|
The remote server is the full product and needs nothing installed. The local server in this repository is a small, dependency-light stdio client over the same public REST API, for clients that cannot speak streamable HTTP or for users who would rather run the process themselves.
Quick start — remote
Claude Desktop (Custom Connector)
Open Claude Desktop → Settings → Custom Connectors
Add Connector:
Name: EDINET DB
URL:
https://edinetdb.jp/mcpAuth: OAuth 2.0 (discovery:
https://edinetdb.jp/mcp/.well-known/oauth-authorization-server)
Sign in with your edinetdb.jp account (free signup at https://edinetdb.jp/signup)
Claude Code
claude mcp add edinetdb https://edinetdb.jp/mcp --transport httpCursor
.cursor/mcp.json:
{
"mcpServers": {
"edinetdb": {
"url": "https://edinetdb.jp/mcp",
"transport": "streamable-http"
}
}
}Codex CLI
codex mcp add edinetdb https://edinetdb.jp/mcpQuick start — local stdio server
Get a free API key at https://edinetdb.jp/developers, then:
EDINETDB_API_KEY=your-key npx -y github:edinetdb/edinet-db-mcpClaude Desktop / Cursor / any stdio client:
{
"mcpServers": {
"edinetdb": {
"command": "npx",
"args": ["-y", "github:edinetdb/edinet-db-mcp"],
"env": { "EDINETDB_API_KEY": "your-key" }
}
}
}From source:
git clone https://github.com/edinetdb/edinet-db-mcp && cd edinet-db-mcp
npm ci && EDINETDB_API_KEY=your-key node server.jsWith Docker (-i is required — the transport is stdio):
docker build -t edinet-db-mcp .
docker run -i --rm -e EDINETDB_API_KEY=your-key edinet-db-mcpEnvironment variable | Required | Default | Purpose |
| yes, to call tools | — | Your EDINET DB API key. Listing tools works without it. |
| no |
| REST API base URL. |
| no |
| Per-request timeout in milliseconds. |
Tools in the local server (13)
Each tool is a typed wrapper over one REST endpoint. The set is deliberately narrow: one tool per question a user actually asks, with no two tools covering the same ground.
Tool | What it answers |
| Resolve a name or securities code to an EDINET code |
| Full profile of one company |
| Multi-year financial statement series |
| Which business segment earns the money |
| Latest quarterly results and company forecast |
| What the company filed, and when |
| Business overview, risk factors, MD&A as filed |
| Board roster, tenure and shareholding |
| Who holds 5%+ of this company |
| Everything one investor holds |
| Filter the market by numeric criteria |
| Market-wide league table for one metric |
| Benchmark a company against its industry |
For the full surface — IR documents, knowledge-graph strategies, KPI tracking, watchlists, dashboards and saved analyses — use the remote server, which exposes all 75 tools listed below.
Tools in the remote server (75)
Company & financials
get_company— Company profile + latest financials (XBRL-sourced, no LLM)get_financials— Multi-year financial time seriesget_analysis— Rule-based financial health score (0-100) and key-metrics summarycompare_companies— Side-by-side comparison of 2-10 companies for one fiscal yearget_industry_benchmark— Industry median and P25/P75 quartilesget_fair_value— Deterministic, non-advisory valuation model estimatesget_segments— Business segment revenue, operating income, capex, assetsget_detailed_expenses— SG&A breakdown from the PL notesget_order_backlog— Orders received, order backlog, production and sales volumesget_earnings— Quarterly earnings flash (決算短信), newest firstget_earnings_calendar— Scheduled earnings announcement dates
Search & screening
search_companies— Search by name, securities code, industry, or health scoresearch_companies_batch— Many companies in one callscreen_companies— Screener over 100+ metrics with AND logicget_ranking— Top companies by a financial, human-capital or ESG metricsearch_corporate_master— National Tax Agency corporate-number database (5.8M+ active corporations)get_corporate_profile— Profile by 13-digit corporate number, listed or notget_events— Normalized corporate events across filings, earnings and holdingsget_appearances— Reverse-lookup: how a company appears in other companies' filings
Filings: full text & structured extraction
get_text_blocks— Raw full text from annual securities reportsget_text_blocks_structured— Pre-extracted structured data points from those sectionsget_compensation_text— Director and officer compensation disclosuresget_company_history— Corporate history timeline (沿革) as structured events
Shareholders
get_shareholders— Large shareholding reports (大量保有報告書), latest per filer groupsearch_shareholders— Which companies a given filer holdsget_shareholder_history— Shareholding time series for a filer-issuer pairget_shareholder_transactions— Trade-level detail from the 60-day acquisition/disposal tableget_activist_positions— Current activist positions across the marketget_shareholder_categories— Ownership by shareholder category (所有者別状況)get_major_shareholders— Top-10 major shareholders snapshotget_cross_shareholdings— Per-issuer policy shareholdings (政策保有株式)
Corporate graph
get_directors— Directors and corporate auditors (役員一覧)get_director_compensation— Granular compensation breakdown per officer groupget_parent_company/get_parent_companies— Disclosed parent and reverse-declared parentsget_subsidiaries— Consolidated subsidiaries and equity-method affiliates (関係会社の状況)get_gleif_subsidiaries— Consolidated subsidiaries from GLEIF Level 2get_related_party_transactions— Related-party transactions (関連当事者との取引)get_main_customers— Disclosed main customers (主要販売先) graph
Assets & facilities
get_real_estate— Land, buildings and investment property book valuesget_facilities— Facility-level major properties (主要な設備の状況)
IR documents & knowledge graph
get_ir_documents— IR PDFs: integrated reports, mid-term plans, sustainability reportsget_ir_pdf_url— Signed download URL for an IR PDFlist_ir_document_types— Available IR document type slugssearch_ir_sections/get_ir_sections_by_company— Section-level IR content searchsearch_qa_sections— Q&A content from earnings presentationssearch_ir_kpis/get_ir_kpis_by_company— Numeric KPIs from mid-term plans and integrated reportssearch_kg_strategies— Strategy entities extracted across companiessearch_kg_kpi_commitments— Committed numerical targetsget_kg_company_summary— Knowledge-graph summary for one companyget_kg_kpi_track_record— KPI commitments, observations and revisionsfind_peer_strategies— Peer strategies that overlap thematically
Watchlist, dashboard & notifications
get_watchlist/add_to_watchlist/remove_from_watchlist— Personal watchlistdashboard_list_modules/dashboard_get_feed/dashboard_add_module/dashboard_remove_module/dashboard_update_params— Dashboard modules and live feedssubscribe_notifications/list_notification_subscriptions/unsubscribe_notifications— Email digests
Saved analyses
save_analysis/list_my_analyses/run_analysis/delete_analysis— Re-runnable named analyses
Data quality feedback
report_data_issue/report_financial_data_issue— Flag an error or missing dataget_data_issue— Status of a report you filedrequest_data/list_my_data_requests— Request data that is missing entirely
Docs
get_documentation— Inline help, tool catalog and methodology
Data sources
Source | Coverage | License |
EDINET (FSA Japan) | Annual securities reports, quarterly reports, large shareholder reports | Public-sector open data |
gBizINFO (METI) | Corporate basic attributes, patents, subsidies, government procurement | CC BY 4.0 compatible (政府標準利用規約 第2.0版) |
Corporate Number Publication Site (NTA) | Corporate number, basic 3 fields | 公共データ利用規約 第1.0版 |
Wikidata | Official website URLs | CC0 |
AI-generated content (corporate history narrative, etc.) | Always labeled, with source event IDs, timestamps, and disclaimers | — |
We do not redistribute exchange-licensed data (real-time stock prices, TDnet). See https://edinetdb.jp/docs/data-sources for the full breakdown.
Pricing
Plan | Price (JPY/month) | API/MCP req/day |
Free | ¥0 | 100 |
Pro | ¥4,980 | 1,000 |
Developer (formerly Business, renamed 2026-09-03) | ¥29,800 | 10,000 |
Business (organizations) / Enterprise | Contact | Custom |
Academy | Free for accredited researchers | Custom |
Details: https://edinetdb.jp/pricing
Position vs. similar projects
EDINET DB runs as a hosted, OAuth-authenticated, multi-tenant remote MCP server, and also ships the local stdio client in this repository for people who would rather run the process themselves. It has been in production since 2026-03-01 and has 9,000+ registered users.
Languages
Japanese (primary), English (secondary, growing)
Tools accept queries in both languages, response language follows MCP client
Accept-Language
License & terms
Data: see "Data sources" table above; each field carries a
sourceattributeService: per https://edinetdb.jp/terms
Not an official endorsement of any governmental body
Links
🌐 Service: https://edinetdb.jp
📚 Docs: https://edinetdb.jp/docs/api
🔌 MCP guide: https://edinetdb.jp/docs/mcp-guide
📊 Data quality SLA: https://edinetdb.jp/docs/data-quality
✉️ Contact: edinetdb@cabocia.jp
Operated by Cabocia Inc. — building data infrastructure for the AI agent era.
Available Tools
13 toolscompare_peersAInspect
Benchmark one company against its industry peers on a single metric over several years, returning the company's own series, each peer's series and the industry distribution. Answers 'is this good?', which a single company's numbers alone cannot.
Inputs: metric (required), company (required), years, peer_count.
get_companyAInspect
Get the full profile of one company: identifiers, industry, market segment, headcount and the most recent reported financial summary. This is the general 'tell me about this company' tool; for a multi-year numeric series use get_financials.
Inputs: code (required), fields.
get_directorsAInspect
Get the board roster disclosed by one company: each director and corporate auditor with their title, responsibilities, tenure and shareholding. Answers governance and board-composition questions.
Inputs: code (required), fiscal_year.
get_disclosuresAInspect
List the regulatory documents one company filed in a given period, with filing dates and document types. Use this to answer 'what did they file and when'; use get_text_blocks to read the narrative content of a filing.
Inputs: code (required), month, since, types, +1 more.
get_earningsAInspect
Get a company's quarterly earnings releases (決算短信) newest first, including reported results and management's own forecast for the year. These arrive weeks before the annual report, so use this for the latest numbers and get_financials for the audited long-run series.
Inputs: code (required), limit, include_qualitative_text.
get_financialsAInspect
Get the multi-year financial statement time series for one company — revenue, operating income, net income, assets, equity and cash flow per period. Figures come from XBRL in the company's own regulatory filings; no language model is involved in producing them.
Inputs: code (required), years, period.
get_rankingAInspect
Get the market-wide league table for one metric — the top companies by return on equity, market capitalisation, dividend yield, female director ratio and 45 others. Use this for 'who is highest on X'; use screen_companies when you need several conditions at once.
Inputs: metric (required), limit.
get_segmentsAInspect
Get the reported business-segment breakdown for one company: revenue, operating income, assets, depreciation and capital expenditure per segment. Use this to see which part of a business actually earns money, which consolidated totals in get_financials cannot show.
Inputs: code (required), period, quarter, fiscal_year.
get_text_blocksAInspect
Read the narrative sections of a company's annual securities report — business overview, risk factors, and management's discussion and analysis — as the original filed Japanese text. Returns a 2,000-character excerpt per section unless full is set.
Inputs: code (required), full, sections, fiscal_year.
screen_companiesAInspect
Filter the whole universe of Japanese listed companies by numeric and categorical criteria combined with AND, and sort the survivors. Use this when you are looking for companies that match a profile; use search_companies when you already know which company you mean.
Inputs: sort, limit, order, market, +5 more.
search_companiesAInspect
Resolve a company name, EDINET code, or securities code to a company record. Use this first when you know WHO you are looking for and need its EDINET code for the other tools. For finding companies by numeric criteria you do not yet have a name for, use screen_companies instead.
Inputs: q (required), limit, include_delisted.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool maps to a distinct resource or action, with overlapping pairings explicitly cross-referenced: get_shareholders vs search_shareholders and search_companies vs screen_companies are clearly differentiated. Adjacent tools like get_financials vs get_earnings and get_disclosures vs get_text_blocks are also described in ways that prevent misselection.
All tools follow a consistent snake_case verb_noun pattern: get_* for retrieving entity data, search_* for resolving names, screen_companies for filtering, and compare_peers for benchmarking. The verb consistently indicates the operation type and the noun the target, making the set highly predictable.
Thirteen tools is well-scoped for an EDINET financial data server, covering company profile, financials, segments, earnings, disclosures, governance, shareholders, screening, ranking, and peer comparison. Each tool earns its place and there are no obvious redundant entries.
The toolset covers the major EDINET workflows thoroughly: company resolution, financial statements, quarterly earnings, filing lists, narrative text, directors, shareholder filings, screening, ranking, and peer comparison. A minor gap is that arbitrary full-filing content cannot be retrieved directly, since get_text_blocks is limited to annual securities report narrative sections.
Related MCP Connectors
EDINET filings of Japanese stocks: financial statements, segments, shareholders. No stock prices.
Cross-market (US/JP/KR) structured financials, segments, ownership & metrics, traceable to filings.
Japanese public records on 1-10 companies per call: FSA, MOF, EDINET, ISA, gBizINFO. Evidence only.
Financial data and research MCP for US/CN/JP equities: filings, statements, ownership, signals.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides comprehensive access to financial filings from 7,700+ Asian companies through Japan's EDINET and South Korea's DART systems, enabling search, retrieval, and analysis of financial statements, XBRL data, and dimensional breakdowns.13MIT
- AlicenseAqualityDmaintenanceLets 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.414 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server providing raw Japanese regulatory corporate data, including pension headcount logs, statutory financial disclosures, and government procurement records, metered via x402 micro-payments.MIT
- AlicenseAqualityBmaintenanceEnables MCP clients to search verified Japanese corporate records — EDINET XBRL financials, 13-digit corporate numbers, major shareholders, and gBizINFO certifications — locally through a single knowledge-search tool with keyword, fuzzy, semantic, or hybrid retrieval. It also maps J-GAAP, US GAAP, and IFRS concepts so filings can be read in English without mistranslating terms like 営業利益 and 経常利益.754 npmMIT