Skip to main content
Glama
EDINET DB MCP Server

EDINET DB MCP Server

EDINET DB MCP Server

Live Users License

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

https://edinetdb.jp/mcp

runs on your machine

Tools

75

13 core tools

Auth

OAuth 2.0 or API key

API key (EDINETDB_API_KEY)

Setup

add one URL

npx, node, or Docker

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

Environment variable

Required

Default

Purpose

EDINETDB_API_KEY

yes, to call tools

—

Your EDINET DB API key. Listing tools works without it.

EDINETDB_BASE_URL

no

https://edinetdb.jp/v1

REST API base URL.

EDINETDB_TIMEOUT_MS

no

30000

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

search_companies

Resolve a name or securities code to an EDINET code

get_company

Full profile of one company

get_financials

Multi-year financial statement series

get_segments

Which business segment earns the money

get_earnings

Latest quarterly results and company forecast

get_disclosures

What the company filed, and when

get_text_blocks

Business overview, risk factors, MD&A as filed

get_directors

Board roster, tenure and shareholding

get_shareholders

Who holds 5%+ of this company

search_shareholders

Everything one investor holds

screen_companies

Filter the market by numeric criteria

get_ranking

Market-wide league table for one metric

compare_peers

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

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 source attribute

  • Service: per https://edinetdb.jp/terms

  • Not an official endorsement of any governmental body


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

Available Tools

13 tools
compare_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_shareholdersAInspect

Get the large-shareholding reports filed against one company — who has declared a stake of 5% or more, at what ratio, and as of when. This is the issuer-side view; to go the other way and see everything one investor holds, use search_shareholders.

Inputs: code (required).

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.

search_shareholdersAInspect

Look up an investor by name and get every listed company where it has filed a large-shareholding report. This is the reverse of get_shareholders: start from the holder, not the issuer.

Inputs: q (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 13 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides 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.
      1
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Lets 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.
      4
      14 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server providing raw Japanese regulatory corporate data, including pension headcount logs, statutory financial disclosures, and government procurement records, metered via x402 micro-payments.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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 経常利益.
      7
      54 npm
      MIT