Skip to main content
Glama
gotoai

edinet-util-mcp-server

by gotoai

edinet-util-mcp-server

An MCP server for the EDINET API v2 (金融庁), and the builder of the company-profile snapshot used by the edinet-company-profiles skill.

EDINET API v2 を使って有価証券報告書などの開示書類を扱う MCP サーバーと、上場企業のプロフィール・ 主要指標・同業他社リストをまとめたスナップショットのビルダーです。

Unofficial. This project is not affiliated with or endorsed by the Financial Services Agency (金融庁), which operates EDINET.

Status: work in progress. The snapshot builder works; the MCP server is not built yet.

Layout

Path

What it is

src/edinet_util_mcp_server/

The package: API client (api), code list (codelist), key figures from the type-5 CSV (figures)

tools/build_profiles.py, tools/snapshot/

The snapshot builder, a development tool not shipped in the wheel

skill/edinet-company-profiles/

The skill; the builder writes its database to data/edinet_profiles.sqlite (not in git)

Related MCP server: edinet-mcp

Building the snapshot

Put the key in .env at the repository root (EDINET_API_KEY=…; the file is ignored by git), then:

python tools/build_profiles.py all

Steps, each re-runnable on its own: cohort (every listed company in the EDINET code list) → filings (every cohort filing in the daily lists of the last 18 months, or --from..--to) → profiles (key figures and listing market from each latest annual report's CSV; a company is covered when that report shows at least 3 fiscal years) → peers (top 10 per company in the same TSE industry, scored 0.5 × scale similarity + 0.5 × similarity of the report's 事業の内容 and 経営方針 text) → finish (manifest, attribution, VACUUM).

The builder needs the dev extras (pip install -e ".[dev]", which include numpy and scikit-learn for the peers step); the server itself does not.

Downloads are cached in build/edinet-cache/, so an interrupted run resumes and a rebuild makes no repeat calls. Requests go one at a time, 1 second apart, slowing down after an HTTP 429.

Data and licence

The code is MIT-licensed. Data from EDINET is used under the 公共データ利用規約(第1.0版) (PDL1.0). The snapshot is processed data, not the original filings:

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides programmatic access to Japan's EDINET system to search for listed companies and retrieve annual or quarterly financial reports. It parses XBRL filings into structured data, enabling AI assistants to analyze balance sheets, income statements, and cash flows.
    131 PyPI
    19
    Apache 2.0
  • F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that interfaces with the Japanese EDINET API v2 to search, download, and extract text from financial disclosure documents. It enables users to browse disclosure lists, retrieve document originals, and perform natural language searches for specific financial filings.
    -
  • A
    license
    A
    quality
    C
    maintenance
    Structured financial data for ~3,800 Japanese listed companies from EDINET regulatory filings — financials, major shareholders, segments, executive compensation, and corporate history. Remote MCP over HTTPS with OAuth 2.0, free tier.
    13
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables access and analysis of Japanese corporate financial data (PL/BS/CF) via EDINET API. Supports searching companies, listing reports, and comparing financials through natural language queries.
    1
    MIT