Edinet MCP Server

Access Japanese financial disclosures (EDINET). Search companies, retrieve BS/PL/CF statements.

Local serverstdioPython

What is the Edinet MCP server?

Access Japanese financial disclosures (EDINET). Search companies, retrieve BS/PL/CF statements. The edinet mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.

What it actually does

EDINET XBRL parsing library and MCP server for Japanese financial data.

Adding it to your client

edinet-mcp on PyPI is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Its toolset

Everything the assistant can do here goes through one of these:

  • search_companies — 企業名・証券コード・EDINETコードで検索
  • get_filings — 指定期間の開示書類一覧を取得
  • get_financial_statements — 正規化された財務諸表 (BS/PL/CF) を取得
  • get_financial_metrics — ROE・ROA・利益率等の財務指標を計算
  • compare_financial_periods — 前年比較(増減額・増減率)
  • screen_companies — 複数企業の財務指標を一括比較(最大20社)
  • get_narrative — 定性情報(事業等のリスク・MD&A 等)をページング付きで取得
  • list_available_labels — 取得可能な財務科目の一覧
  • get_company_info — 企業の詳細情報を取得
  • diff_financial_statements — 2期間の財務諸表を比較(増減額・増減率)
  • Installation — The Installation tool exposed by this server
  • EdinetClient — All client methods are async. Use async with for proper resource cleanup:

Configuration

You will need one environment variable: EDINET_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Edinet.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the edinet mcp server does with a few real requests.

When to reach for it

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Edinet's toolset — search_companies, get_filings, get_financial_statements and 11 more — is a fair guide to whether it matches your workflow. It is maintained by ajtgjmdjp; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
search_companies企業名・証券コード・EDINETコードで検索
get_filings指定期間の開示書類一覧を取得
get_financial_statements正規化された財務諸表 (BS/PL/CF) を取得
get_financial_metricsROE・ROA・利益率等の財務指標を計算
compare_financial_periods前年比較(増減額・増減率)
screen_companies複数企業の財務指標を一括比較(最大20社)
get_narrative定性情報(事業等のリスク・MD&A 等)をページング付きで取得
list_available_labels取得可能な財務科目の一覧
get_company_info企業の詳細情報を取得
diff_financial_statements2期間の財務諸表を比較(増減額・増減率)
InstallationThe Installation tool exposed by this server.
EdinetClientAll client methods are async. Use async with for proper resource cleanup:
FilingFiling objects returned by get_filings() have the following attributes:
StatementDataEach financial statement (BS, PL, CF) is a StatementData object with dict-like access:

How to install the Edinet MCP server

{
  "mcpServers": {
    "edinet": {
      "command": "uvx",
      "args": ["edinet-mcp", "serve"],
      "env": {
        "EDINET_API_KEY": "your_key_here"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
EDINET_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Edinet to search companies.
  • Use Edinet to get filings.
  • Use Edinet to get financial statements.

Frequently asked questions

It connects Edinet to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (search_companies, get_filings, get_financial_statements, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Edinet directly.