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.

Two ways to connect

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)

1. Open Claude Desktop → Settings → Custom Connectors
2. Add Connector:
   • Name: EDINET DB
   • URL: https://edinetdb.jp/mcp
   • Auth: OAuth 2.0 (discovery: https://edinetdb.jp/mcp/.well-known/oauth-authorization-server)
3. 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 http

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "edinetdb": {
      "url": "https://edinetdb.jp/mcp",
      "transport": "streamable-http"
    }
  }
}

Codex CLI

codex mcp add edinetdb https://edinetdb.jp/mcp

Quick 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-mcp

Claude 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.js

With 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-mcp

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.

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 series
• get_analysis — Rule-based financial health score (0-100) and key-metrics summary
• compare_companies — Side-by-side comparison of 2-10 companies for one fiscal year
• get_industry_benchmark — Industry median and P25/P75 quartiles
• get_fair_value — Deterministic, non-advisory valuation model estimates
• get_segments — Business segment revenue, operating income, capex, assets
• get_detailed_expenses — SG&A breakdown from the PL notes
• get_order_backlog — Orders received, order backlog, production and sales volumes
• get_earnings — Quarterly earnings flash (決算短信), newest first
• get_earnings_calendar — Scheduled earnings announcement dates

Search & screening

• search_companies — Search by name, securities code, industry, or health score
• search_companies_batch — Many companies in one call
• screen_companies — Screener over 100+ metrics with AND logic
• get_ranking — Top companies by a financial, human-capital or ESG metric
• search_corporate_master — National Tax Agency corporate-number database (5.8M+ active corporations)
• get_corporate_profile — Profile by 13-digit corporate number, listed or not
• get_events — Normalized corporate events across filings, earnings and holdings
• get_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 reports
• get_text_blocks_structured — Pre-extracted structured data points from those sections
• get_compensation_text — Director and officer compensation disclosures
• get_company_history — Corporate history timeline (沿革) as structured events

Shareholders

• get_shareholders — Large shareholding reports (大量保有報告書), latest per filer group
• search_shareholders — Which companies a given filer holds
• get_shareholder_history — Shareholding time series for a filer-issuer pair
• get_shareholder_transactions — Trade-level detail from the 60-day acquisition/disposal table
• get_activist_positions — Current activist positions across the market
• get_shareholder_categories — Ownership by shareholder category (所有者別状況)
• get_major_shareholders — Top-10 major shareholders snapshot
• get_cross_shareholdings — Per-issuer policy shareholdings (政策保有株式)

Corporate graph

• get_directors — Directors and corporate auditors (役員一覧)
• get_director_compensation — Granular compensation breakdown per officer group
• get_parent_company / get_parent_companies — Disclosed parent and reverse-declared parents
• get_subsidiaries — Consolidated subsidiaries and equity-method affiliates (関係会社の状況)
• get_gleif_subsidiaries — Consolidated subsidiaries from GLEIF Level 2
• get_related_party_transactions — Related-party transactions (関連当事者との取引)
• get_main_customers — Disclosed main customers (主要販売先) graph

Assets & facilities

• get_real_estate — Land, buildings and investment property book values
• get_facilities — Facility-level major properties (主要な設備の状況)

IR documents & knowledge graph

• get_ir_documents — IR PDFs: integrated reports, mid-term plans, sustainability reports
• get_ir_pdf_url — Signed download URL for an IR PDF
• list_ir_document_types — Available IR document type slugs
• search_ir_sections / get_ir_sections_by_company — Section-level IR content search
• search_qa_sections — Q&A content from earnings presentations
• search_ir_kpis / get_ir_kpis_by_company — Numeric KPIs from mid-term plans and integrated reports
• search_kg_strategies — Strategy entities extracted across companies
• search_kg_kpi_commitments — Committed numerical targets
• get_kg_company_summary — Knowledge-graph summary for one company
• get_kg_kpi_track_record — KPI commitments, observations and revisions
• find_peer_strategies — Peer strategies that overlap thematically

Watchlist, dashboard & notifications

• get_watchlist / add_to_watchlist / remove_from_watchlist — Personal watchlist
• dashboard_list_modules / dashboard_get_feed / dashboard_add_module / dashboard_remove_module / dashboard_update_params — Dashboard modules and live feeds
• subscribe_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 data
• get_data_issue — Status of a report you filed
• request_data / list_my_data_requests — Request data that is missing entirely

Docs

• get_documentation — Inline help, tool catalog and methodology

Data sources

We do not redistribute exchange-licensed data (real-time stock prices, TDnet). See https://edinetdb.jp/docs/data-sources for the full breakdown.

Pricing

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 source attribute
• Service: 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
• 🐛 Issues: https://github.com/edinetdb/edinet-db-mcp/issues
• ✉️ Contact: edinetdb@cabocia.jp

---

Operated by Cabocia Inc. — building data infrastructure for the AI agent era.