MCP guide
Japan Finsight implements the Model Context Protocol (MCP), an open standard for AI agents to call structured tools and read structured data. Once connected, your AI agent can query Japan's official corporate disclosure data (EDINET) the same way it queries any other tool.
What you can ask
Questions an MCP-connected agent can answer with Japan Finsight tools:
- "Show me the past 5 years of cash flow for Toyota."
- "Which Japanese mid-cap companies have an activist holder filing in the last 12 months?"
- "Walk me through Tokio Marine's recent buybacks and capital policy."
- "What material events has Sony filed in the past 6 months?"
- "Who are the top 10 shareholders of [any listed company], with bilingual names?"
Public tool inventory
17 MCP tools available to subscribers. Every response includes a company block with the ticker, EDINET code, JP/EN names, and sector, so your agent never has to guess the entity.
| Tool | What it returns |
|---|---|
find_companies | Fuzzy name → ticker lookup |
get_financials | Up to 7 yr I/S + B/S |
get_cashflows | Up to 7 yr cash flow |
get_balance_sheet | Latest B/S snapshot, derived ratios |
get_quality_trends | 7-yr ROE / FCF / EPS / DPS trends |
get_shareholders | 5%+ holders, change flags |
get_ownership | Foreign / institutional / corporate / individual % |
get_ownership_timeline | Chronological entry / increase / exit events ★ |
get_holding_actions | Activist intent: change proposals and desired outcomes ★ |
get_cross_holdings | Reciprocal cross-shareholding pairs ★ |
get_buybacks | Treasury buyback filings (Doc 220) |
get_capital_policy | Target payout %, dividend skip reasons ★ |
get_material_events | Doc 180 extraordinary events, classified ★ |
get_tender_offer_history | 6-doc-type unified TOB timeline ★ |
get_related_party_transactions | RPT extracts from annual reports ★ |
get_segments | Operating-segment revenue / profit breakdown ★ |
run_sql | Read-only SQL over the disclosure data (allow-listed tables) ★ |
★ = Japan Finsight extractions and views built on top of the raw EDINET filings.
Protocol
- Transport: Streamable HTTP (per MCP 2025-03-26)
- Auth: Bearer token, X-API-Key header, or
?key=query param - Endpoint:
https://mcp.edinet.tools/mcp(live) - Response formats: JSON or SSE depending on
Acceptheader
Get connected
Pick your AI client. If you're not a developer, use Claude.ai or ChatGPT in your browser; Cursor and Claude Code are for engineers.
- Claude (Claude.ai and Claude Desktop)
- ChatGPT
- Cursor
- Claude Code
Have a setup question? Email data@japanfinsight.com.