edinet-mcp
This server exposes EDINET filing search and document retrieval tools.
List EDINET filings for a required
filing_date(YYYY-MM-DD), optionally filtering by partialfilerand 3-digitdocument_type, withlimit/offsetpagination.Retrieve a filing’s PDF (default) or CSV ZIP using its
document_id.MCP document retrieval is limited to 2 MiB; use the CLI for larger documents.
Requires an EDINET API key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@edinet-mcp 2026年6月30日の有価証券報告書を3件探して"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
edinet-mcp
金融庁EDINETの提出書類一覧を日付で取得し、提出者や書類種別で絞れます。一覧で得た書類管理番号からPDFやCSVのZIPを取得できます。
uv と Git が必要です。Python 3.12以上に対応しています。EDINETの案内に従ってAPIキーを発行し、例の YOUR_EDINET_API_KEY を手元の設定で差し替えてください。
MCP登録 · CLI · Pythonライブラリ
MCPクライアントに登録する
Codex
codex mcp add edinet-mcp --env "EDINET_API_KEY=YOUR_EDINET_API_KEY" -- uvx --python 3.12 --from git+https://github.com/koizumikento/edinet-mcp.git@main edinet-mcp
codex mcp list新しいセッションで /mcp を開いて接続を確認できます。デスクトップ版ではMCP設定画面で、下のJSON例と同じコマンド・引数・環境変数を指定できます。
Claude Desktop / Cursor
Claude Desktop(Windows)
%APPDATA%/Claude/claude_desktop_config.jsonClaude Desktop(macOS)
~/Library/Application Support/Claude/claude_desktop_config.jsonCursor
.cursor/mcp.json(プロジェクト内)
設定ファイルの mcpServers に項目を追加して、クライアントを再起動してください。uvx が見つからない場合は実行ファイルの絶対パスを指定します。
{
"mcpServers": {
"edinet-mcp": {
"command": "uvx",
"args": [
"--python",
"3.12",
"--from",
"git+https://github.com/koizumikento/edinet-mcp.git@main",
"edinet-mcp"
],
"env": {
"EDINET_API_KEY": "YOUR_EDINET_API_KEY"
}
}
}
}2026年6月30日のEDINET提出書類から、有価証券報告書を3件探して。
Related MCP server: edinet-mcp
MCPツール
list_filings
filing_date は YYYY-MM-DD の一覧ファイル日付です。filer は提出者名・EDINETコード・証券コードの部分一致です。document_type は3桁の書類種別コードで、例の 120 は有価証券報告書です。結果は書類管理番号、提出日時、取下げ・開示の区分、pdf_flag と csv_flag を含みます。形式が利用可能な場合、該当のフラグは "1" です。続きがあれば next_offset を返します。
get_filing_document
一覧から得た document_id を指定します。format は pdf(既定)または csv です。PDFはEDINETの検索結果から表示できる書類本体です。CSVはEDINETがXBRLから変換したデータを格納したZIPで、展開せず原本を返します。開示状況や形式によって取得できない書類があります。
EDINETの応答はPDFが application/pdf、CSVのZIPが application/octet-stream です。このツールはZIPを application/zip として返します。MCPの埋め込みリソースはこのツールの上限として原本2 MiBまでです。クライアントがこの形式を表示できない場合や、2 MiBを超える場合はCLIを使ってください。
CLIで使う
PowerShellでは $env:EDINET_API_KEY = "YOUR_EDINET_API_KEY"、macOSやLinuxでは export EDINET_API_KEY="YOUR_EDINET_API_KEY" を先に実行します。APIキーは手元で管理してください。
uvx --python 3.12 --from git+https://github.com/koizumikento/edinet-mcp.git@main edinet-mcp list-filings --date 2026-06-30 --document-type 120 --limit 3
uvx --python 3.12 --from git+https://github.com/koizumikento/edinet-mcp.git@main edinet-mcp get-filing-document --document-id S1234567 --format pdf --output filing.pdf
uvx --python 3.12 --from git+https://github.com/koizumikento/edinet-mcp.git@main edinet-mcp get-filing-document --document-id S1234567 --format csv --output filing-csv.zip例の S1234567 は取得したい書類の管理番号に置き換えます。書類は最大32 MiBまで、指定した新規ファイルに保存します。結果は標準出力にUTF-8のJSONで返ります。
Pythonライブラリとして使う
自分のPythonプロジェクト(pyproject.toml があるディレクトリ)で依存関係に追加します。CLIで使うと同様に、実行するシェルで EDINET_API_KEY を設定してください。
uv add "git+https://github.com/koizumikento/edinet-mcp.git@main"次のコードを example.py に保存し、同じディレクトリで uv run python example.py を実行します。
import asyncio
from edinet_mcp import get_filing_document, list_filings
async def main() -> None:
filings = await list_filings("2026-06-30", document_type="120", limit=3)
for filing in filings["items"]:
if filing["csv_flag"] == "1":
document = await get_filing_document(filing["document_id"], format="csv")
print(document.metadata)
return
print("CSVを取得できる書類がありません。")
asyncio.run(main())書類のバイト列は document.content から取得できます。取得上限は32 MiBです。max_bytes で上限を小さくできます。既にイベントループがある場合は関数を直接 await してください。
出典と利用条件
コードはMIT Licenseです。金融庁EDINET API v2の書類一覧APIと書類取得APIを使っています。公式仕様・EDINET利用規約
開発
uv sync --locked
uv run ruff check .
uv run ty check
uv run pytest
uv buildAvailable Tools
2 toolsget_filing_documentARead-onlyIdempotent
Retrieve a filing's PDF or CSV ZIP by ID. Use the CLI for files over 2 MiB.
Inputs: document_id (required), format.
list_filingsBRead-onlyIdempotent
List EDINET filing records for a date, filtered by filer or document type.
Inputs: filing_date (required), filer, limit, offset, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools are clearly distinct: list_filings discovers filings, while get_filing_document retrieves the actual PDF/CSV for a known ID. There is no overlap or risk of misselection.
Both tools follow a consistent snake_case verb_noun pattern (list_filings, get_filing_document). The convention is predictable and readable.
Two tools is on the thin side for a filing-data domain; discovery and retrieval are covered but remain a minimal surface. It is borderline rather than mismatched.
The core list-then-fetch workflow is covered, but there is no metadata lookup for a single filing, no search by company/ticker or date range, and no way to enumerate document types. Agents needing richer queries would hit dead ends.
Maintenance
Related MCP Connectors
Japanese public records on 1-10 companies per call: FSA, MOF, EDINET, ISA, gBizINFO. Evidence only.
Remote MCP for Japan's EDINET DB — 3,800 listed companies' financials & filings (OAuth)
EDINET filings of Japanese stocks: financial statements, segments, shareholders. No stock prices.
Search Japanese subsidies and public company data using J-Grants, gBizINFO, and EDINET.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides 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.13MIT
- AlicenseNot gradedqualityCmaintenanceProvides 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.146 PyPI20Apache 2.0
- AlicenseNot gradedqualityBmaintenanceMCP server for Japan's TDnet (Timely Disclosure network). Search and retrieve timely disclosure documents from listed companies on Japanese stock exchanges.243 PyPI6Apache 2.0
- AlicenseAqualityCmaintenanceStructured 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.131MIT