Click on "Install 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-mcpGet the 2024 income statement for Toyota (E02144)"
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 XBRL parsing library and MCP server for Japanese financial data.
What is this?
edinet-mcp provides programmatic access to Japan's EDINET financial disclosure system. It parses XBRL filings into structured DataFrames and exposes them as an MCP server for AI assistants.
Search 5,000+ listed Japanese companies
Retrieve annual/quarterly financial reports (有価証券報告書, 四半期報告書)
Parse XBRL into Polars/pandas DataFrames (BS, PL, CF)
MCP server for Claude Desktop and other AI tools
J-GAAP / IFRS / US-GAAP detection
Quick Start
Installation
pip install edinet-mcp
# or
uv add edinet-mcpGet an API Key
Register (free) at EDINET and set:
export EDINET_API_KEY=your_key_here30-Second Example
from edinet_mcp import EdinetClient
client = EdinetClient()
# Search for Toyota
companies = client.search_companies("トヨタ")
print(companies[0].name, companies[0].edinet_code)
# トヨタ自動車株式会社 E02144
# Get financial statements as a Polars DataFrame
stmt = client.get_financial_statements("E02144", period="2024")
print(stmt.income_statement.to_polars())MCP Server (for Claude Desktop)
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"edinet": {
"command": "uvx",
"args": ["edinet-mcp", "serve"],
"env": {
"EDINET_API_KEY": "your_key_here"
}
}
}
}Then ask Claude: "トヨタの最新の営業利益を教えて"
Available MCP Tools
Tool | Description |
| 企業名・証券コード・EDINETコードで検索 |
| 指定期間の開示書類一覧を取得 |
| 財務諸表 (BS/PL/CF) を構造化データで取得 |
| 企業の詳細情報を取得 |
CLI
# Search companies
edinet-mcp search トヨタ
# Fetch income statement
edinet-mcp statements -c E02144 -p 2024
# Start MCP server
edinet-mcp serveAPI Reference
EdinetClient
client = EdinetClient(
api_key="...", # or EDINET_API_KEY env var
cache_dir="~/.cache/edinet-mcp",
rate_limit=0.5, # requests per second
)
# Search
companies: list[Company] = client.search_companies("query")
company: Company = client.get_company("E02144")
# Filings
filings: list[Filing] = client.get_filings(
start_date="2024-01-01",
edinet_code="E02144",
doc_type="annual_report",
)
# Financial statements
stmt: FinancialStatement = client.get_financial_statements(
edinet_code="E02144",
period="2024",
)
df = stmt.income_statement.to_polars() # Polars DataFrame
df = stmt.income_statement.to_pandas() # pandas DataFrame (optional dep)StatementData
Each financial statement (BS, PL, CF) is a StatementData object:
stmt.balance_sheet.to_polars() # → polars.DataFrame
stmt.balance_sheet.to_pandas() # → pandas.DataFrame (requires pandas)
stmt.balance_sheet.to_dicts() # → list[dict]
len(stmt.balance_sheet) # number of line itemsDevelopment
git clone https://github.com/ajtgjmdjp/edinet-mcp
cd edinet-mcp
uv sync --dev
uv run pytest -v
uv run ruff check .
uv run mypy src/Data Attribution
This project uses data from EDINET (Electronic Disclosure for Investors' NETwork), operated by the Financial Services Agency of Japan (金融庁). EDINET data is provided under the Public Data License 1.0.
Related Projects
edinet2dataset — Sakana AI's EDINET XBRL→JSON tool
EDINET-Bench — Financial classification benchmark
jfinqa — Japanese financial QA benchmark (companion project)
License
Apache-2.0. See NOTICE for third-party attributions.