Tools
16 MCP tools available to subscribers. Each tool returns structured JSON; ticker-keyed tools include a company block (ticker, EDINET code, JP/EN names, sector) so your agent never has to infer entity identity from a ticker number.
find_companies
Look up a Japanese company by name (English or Japanese) or ticker code.
When to use: Fuzzy company name → ticker lookup when you don't know the ticker.
find_companies(search_term: str) -> strget_balance_sheet
Get latest balance sheet data for a Japanese company.
When to use: Latest-filed balance sheet snapshot for a ticker.
get_balance_sheet(ticker: str) -> strget_buybacks
Get recent treasury stock buyback filings (past 12 months).
When to use: Treasury-stock acquisition history (Doc 220) for a ticker.
get_buybacks(ticker: str) -> strget_capital_policy
Get the company's stated capital-return policy from its latest Doc 120.
When to use: Target dividend payout ratio + skip reason for a ticker (LLM-extracted from Doc 120 capital-policy text blocks).
get_capital_policy(ticker: 'str') -> 'str'get_cashflows
Get multi-year cash flow history (up to 7 years).
When to use: Multi-year cash-flow statement time series by ticker.
get_cashflows(ticker: str) -> strget_cross_holdings
Get cross-shareholding relationships for a company.
When to use: Reciprocal cross-shareholding pairs involving a ticker.
get_cross_holdings(ticker: str) -> strget_financials
Get multi-year financial history for a Japanese company (up to 7 years).
When to use: Multi-year income statement and balance sheet time series by ticker.
get_financials(ticker: str) -> strget_holding_actions
Get recent filings where shareholders are pursuing changes (past 12 months).
When to use: Active activist campaigns against a ticker with stated proposals and desired outcomes.
get_holding_actions(ticker: 'str') -> 'str'get_material_events
Get recent extraordinary reports / material events (past 12 months).
When to use: Doc 180 extraordinary-event classifications (category + ordinance item) for a ticker.
get_material_events(ticker: 'str') -> 'str'get_ownership
Get ownership breakdown for a Japanese company.
When to use: Aggregate ownership breakdown (foreign / float / institutional / corporate / individual) for a ticker.
get_ownership(ticker: str) -> strget_ownership_timeline
Return JSON: chronological Doc 350 ownership-change events for a ticker.
When to use: Chronological 5%+ ownership change events for a ticker — who built up, who reduced, who exited. Use for activist-campaign timelines, exit detection, and stake-building narratives. Distinct from get_shareholders (latest snapshot) and get_holding_actions (enriched activist intent).
get_ownership_timeline(ticker: str, window_months: int = 36) -> strget_quality_trends
Get up to 7 years of quality and capital allocation trends for a Japanese company.
When to use: Multi-year ROE/ROA/margin trends for a ticker.
get_quality_trends(ticker: str) -> strget_related_party_transactions
Return related-party transactions for a ticker as JSON.
When to use: Related-party transactions (LLM-extracted from Doc 120 RPT sections) for a ticker.
get_related_party_transactions(ticker: 'str') -> 'str'get_research_bundle
Return the full research bundle for a ticker as JSON.
When to use: Comprehensive research bundle for a ticker — financials, ownership, governance, catalysts, narrative-ready format. Heavyweight; prefer narrower typed tools when only one section is needed.
get_research_bundle(ticker: str) -> strget_shareholders
Get top shareholders from large holding reports (5%+ ownership filings) with change tracking.
When to use: Top 5%+ holders from Doc 350 large-holding filings, with NEW/INCREASED/REDUCED change flags.
get_shareholders(ticker: str) -> strget_tender_offer_history
Return JSON: chronologically sorted tender-offer events for `ticker`.
When to use: Full chronological tender-offer history for a ticker — registrations, withdrawals, results, target opinions, Q&A responses, exemptions, all tagged with event_type.
get_tender_offer_history(ticker: str) -> str