Edinet Db Mcp

io.github.edinetdbPublished by GitHub account edinetdbv1.0.0Updated Oct 24, 2026

Remote MCP for Japan's EDINET DB — 3,800 listed companies' financials & filings (OAuth)

VerifiedStreamable HTTPWeb executableFinanceKnowledge & MemoryData & Analytics

Overview

AI-generated overview

Remote MCP server for Japan's EDINET DB, letting an assistant query financials, filings and shareholder data for about 3,800 Japanese listed companies.

What you can do
Search and screen companies by name, securities code, industry or financial criteria, and compare peers or industry benchmarks. Retrieve multi-year financial statements, segments, earnings, forecasts and valuation or health-score summaries. Read filing full text, structured extracts, corporate history, directors, compensation and related-party data. Look up large shareholding reports, activist positions, major shareholders and cross-shareholdings. Explore corporate graphs such as parents, subsidiaries, main customers and GLEIF links. Manage a watchlist, dashboard modules, email notification subscriptions and saved analyses.
When to use it
Useful for equity research, screening and due diligence on Japanese listed companies, or for answering questions grounded in EDINET filings and public corporate data. The remote endpoint is the full product; a smaller local stdio client exists for clients that cannot use streamable HTTP.
Requirements
Remote endpoint over streamable HTTP with OAuth 2.0 sign-in to an edinetdb.jp account (free signup); an API key is an alternative. The optional local stdio server needs Node.js or Docker and the EDINETDB_API_KEY environment variable. Network access required.
Before you install
Requires an account and, on paid plans, a subscription; free tier is limited to 100 requests per day. Tools can write to your account: watchlist add/remove, dashboard modules, email notification subscriptions and saved analyses including deletion. Data comes from public filings and open data plus some labeled AI-generated content; it is not investment advice and excludes exchange-licensed prices.

Installation

In SourceWeft

  1. Open Edinet Db Mcp in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.edinetdb%2Fedinet-db-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "edinet-db": {
      "type": "http",
      "url": "https://edinetdb.jp/mcp"
    }
  }
}

README

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.

Two ways to connect

Remote (recommended)Local stdio server (this repo)
Endpointhttps://edinetdb.jp/mcpruns on your machine
Tools7513 core tools
AuthOAuth 2.0 or API keyAPI key (EDINETDB_API_KEY)
Setupadd one URLnpx, 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

bash
claude mcp add edinetdb https://edinetdb.jp/mcp --transport http

Cursor

.cursor/mcp.json:

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

Codex CLI

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

Quick start — local stdio server

Get a free API key at https://edinetdb.jp/developers, then:

bash
EDINETDB_API_KEY=your-key npx -y github:edinetdb/edinet-db-mcp

Claude Desktop / Cursor / any stdio client:

json
{  "mcpServers": {    "edinetdb": {      "command": "npx",      "args": ["-y", "github:edinetdb/edinet-db-mcp"],      "env": { "EDINETDB_API_KEY": "your-key" }    }  }}

From source:

bash
git clone https://github.com/edinetdb/edinet-db-mcp && cd edinet-db-mcpnpm ci && EDINETDB_API_KEY=your-key node server.js

With Docker (-i is required — the transport is stdio):

bash
docker build -t edinet-db-mcp .docker run -i --rm -e EDINETDB_API_KEY=your-key edinet-db-mcp
Environment variableRequiredDefaultPurpose
EDINETDB_API_KEYyes, to call tools—Your EDINET DB API key. Listing tools works without it.
EDINETDB_BASE_URLnohttps://edinetdb.jp/v1REST API base URL.
EDINETDB_TIMEOUT_MSno30000Per-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.

ToolWhat it answers
search_companiesResolve a name or securities code to an EDINET code
get_companyFull profile of one company
get_financialsMulti-year financial statement series
get_segmentsWhich business segment earns the money
get_earningsLatest quarterly results and company forecast
get_disclosuresWhat the company filed, and when
get_text_blocksBusiness overview, risk factors, MD&A as filed
get_directorsBoard roster, tenure and shareholding
get_shareholdersWho holds 5%+ of this company
search_shareholdersEverything one investor holds
screen_companiesFilter the market by numeric criteria
get_rankingMarket-wide league table for one metric
compare_peersBenchmark 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

SourceCoverageLicense
EDINET (FSA Japan)Annual securities reports, quarterly reports, large shareholder reportsPublic-sector open data
gBizINFO (METI)Corporate basic attributes, patents, subsidies, government procurementCC BY 4.0 compatible (政府標準利用規約 第2.0版)
Corporate Number Publication Site (NTA)Corporate number, basic 3 fields公共データ利用規約 第1.0版
WikidataOfficial website URLsCC0
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

PlanPrice (JPY/month)API/MCP req/day
Free¥0100
Pro¥4,9801,000
Developer (formerly Business, renamed 2026-09-03)¥29,80010,000
Business (organizations) / EnterpriseContactCustom
AcademyFree for accredited researchersCustom

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

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

Source: README.md at commit 24881d6

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts