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
16 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_research_bundle | Multi-table research package per ticker |
★ = capabilities specific to Japan Finsight; not surfaced by other EDINET data providers.
Protocol
- Transport: Streamable HTTP (per MCP 2025-03-26)
- Auth: Bearer token, X-API-Key header, or
?key=query param - Endpoint:
https://japanfinsight.com/mcp(launches when remote-HTTP MCP support ships. See the changelog for current availability.) - Response formats: JSON or SSE depending on
Acceptheader
Get connected
Pick your AI client:
- Claude (Claude.ai and Claude Desktop)
- ChatGPT
- Cursor
- Claude Code
Have a setup question? Email data@japanfinsight.com.