Tools Reference
Kabuken MCP provides 16 tools across three subscription tiers: BASIC, INVESTOR, and DEVELOPER. BASIC has three kinds of access: 6 free tools (company search, company lookup, industry list, risk context, document list, and account quota), 6 fact tools that work within a free allowance of 3 lookups per day for TOPIX-99 companies, and 4 tools that need INVESTOR or DEVELOPER. INVESTOR and DEVELOPER include all 16 tools — the two differ only in daily request quota, not tool access.
search_companies
Section titled “search_companies”Search for listed Japanese companies by name.
Tier: BASIC (free tool)
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Company name in Japanese or English (partial match supported) |
limit | integer | No | Maximum results to return (default: 10, max: 50) |
Example prompt
Section titled “Example prompt”“Search for companies with ‘Hitachi’ in the name”
get_company
Section titled “get_company”Get details for a specific company by its identifier.
Tier: BASIC (free tool)
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The company identifier value |
id_type | string | No | Type of identifier: COMPANY_ID, TICKER, ENTITY_CODE (default: COMPANY_ID) |
Example prompt
Section titled “Example prompt”“Get details for the company with ticker 7203”
list_industries
Section titled “list_industries”List all industry categories used in Kabuken’s classification.
Tier: BASIC (free tool)
Parameters
Section titled “Parameters”None.
Example prompt
Section titled “Example prompt”“What industries are available to filter by?”
list_documents
Section titled “list_documents”List EDINET filings for a specific company.
Tier: BASIC (free tool)
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
entity_code | string | Yes | EDINET entity code for the company |
limit | integer | No | Maximum results (default: 10, max: 50) |
Example prompt
Section titled “Example prompt”“List the recent filings for Toyota (entity code E02144)“
get_financial_facts
Section titled “get_financial_facts”Retrieve structured financial data (XBRL facts) from a specific filing.
Tier: fact tool. BASIC within the free allowance (3 per day, TOPIX-99 companies); unlimited on INVESTOR or DEVELOPER
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
doc_id | string | Yes | Document ID from list_documents |
statement_type | string | No | Filter by statement: BS (balance sheet), PL (income statement), CF (cash flow) |
lang | string | No | Label language: EN or JA (default: EN) |
Example prompt
Section titled “Example prompt”“Get the income statement facts from Sony’s latest annual report”
get_calculation_tree
Section titled “get_calculation_tree”Show how a financial total decomposes into its component line items, based on the XBRL calculation linkbase.
Tier: fact tool. BASIC within the free allowance (3 per day, TOPIX-99 companies); unlimited on INVESTOR or DEVELOPER
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
doc_id | string | Yes | Document ID from list_documents |
concept | string | No | XBRL concept name to use as the root (omit to return all top-level items) |
lang | string | No | Label language: EN or JA (default: EN) |
Example prompt
Section titled “Example prompt”“Show me how operating profit is calculated in this filing”
get_segment_breakdown
Section titled “get_segment_breakdown”View business segment or geographic breakdowns reported in a filing.
Tier: fact tool. BASIC within the free allowance (3 per day, TOPIX-99 companies); unlimited on INVESTOR or DEVELOPER
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
doc_id | string | Yes | Document ID from list_documents |
lang | string | No | Label language: EN or JA (default: EN) |
Example prompt
Section titled “Example prompt”“Break down revenue by business segment for this company”
get_document_summary
Section titled “get_document_summary”Get an AI-generated summary of a specific filing.
Tier: INVESTOR or DEVELOPER
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
doc_id | string | Yes | Document ID from list_documents |
lang | string | No | Language for the summary: EN or JA (default: EN) |
Example prompt
Section titled “Example prompt”“Summarize the key points from Sony’s latest annual report”
analyze_document
Section titled “analyze_document”Get an AI-powered analysis of a filing’s financial content, including strengths, risks, and notable items.
Tier: INVESTOR or DEVELOPER
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
doc_id | string | Yes | Document ID from list_documents |
lang | string | No | Language for the analysis: EN or JA (default: EN) |
Example prompt
Section titled “Example prompt”“Analyze this filing and highlight key investment considerations”
compare_companies
Section titled “compare_companies”Compare up to 5 companies side by side using key financial metrics.
Tier: fact tool. BASIC within the free allowance (3 per day, TOPIX-99 companies); unlimited on INVESTOR or DEVELOPER
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
entity_codes | string[] | Yes | EDINET entity codes for the companies to compare (max 5) |
Example prompt
Section titled “Example prompt”“Compare Sony, Panasonic, and Sharp on key financial metrics”
screen_companies
Section titled “screen_companies”Filter companies by financial metric thresholds and return matching results.
Tier: INVESTOR or DEVELOPER
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
filters | object[] | Yes | Array of filter conditions, each with metric, operator, and value |
Valid operator values: gt (greater than), lt (less than), gte (greater than or equal), lte (less than or equal), eq (equal).
Example prompt
Section titled “Example prompt”“Find companies with ROE above 10% and debt-to-equity below 1”
get_industry_overview
Section titled “get_industry_overview”Get sector-level aggregated data for a given industry, including company count, mean, median, and top/bottom companies.
Tier: INVESTOR or DEVELOPER
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
industry_id | string | Yes | Industry ID from list_industries |
Example prompt
Section titled “Example prompt”“Give me an overview of the Electric Appliances sector”
get_risk_context
Section titled “get_risk_context”Get risk context indicators for a company: Bank of Japan interest-rate sensitivity and METI export-control classification, derived from its industry.
Tier: BASIC (free tool)
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
entity_code | string | Yes | EDINET entity code of the company (e.g. E02144). Obtain from search_companies or get_company. |
Example prompt
Section titled “Example prompt”“What’s the export control and interest rate risk profile for this company?”
get_company_financials
Section titled “get_company_financials”Retrieve multi-period financial statements (income statement, balance sheet, cash flow) for a company, grouped by statement type across annual and interim filing periods.
Tier: fact tool. BASIC within the free allowance (3 per day, TOPIX-99 companies); unlimited on INVESTOR or DEVELOPER
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
entity_code | string | Yes | EDINET entity code (e.g. E02144 for Toyota). Obtain from search_companies. |
period_type | string | No | Filter by filing period type: ANNUAL, INTERIM, or ALL (default: ANNUAL) |
periods | integer | No | Number of most recent filing periods to return (1-10, default: 3) |
lang | string | No | Label language: EN or JA (default: EN) |
Example prompt
Section titled “Example prompt”“Show me Toyota’s income statement and balance sheet for the last 3 annual reports”
get_major_shareholders
Section titled “get_major_shareholders”Return the major shareholder reports (large shareholding reports, 大量保有報告書) filed for a company: shareholder, ownership percentage, shares held, and filing date. An empty result can mean no processed filings exist yet for the company.
Tier: fact tool. BASIC within the free allowance (3 per day, TOPIX-99 companies); unlimited on INVESTOR or DEVELOPER
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
entity_code | string | Yes | EDINET entity code of the company (e.g. E02144) |
Example prompt
Section titled “Example prompt”“Who are the major shareholders of MUFG?”
get_account_quota
Section titled “get_account_quota”Check the caller’s current daily API quota: subscription tier, calls used today, daily limit, remaining calls, and reset time.
Tier: BASIC (free tool, available on every tier)
Parameters
Section titled “Parameters”None.
Calling this tool does not use up your daily request quota. For BASIC accounts the result also shows the free fact allowance (3 per day, TOPIX-99 companies, resets at 00:00 JST).
Example prompt
Section titled “Example prompt”“How many API calls do I have left today?”
Tool availability by tier
Section titled “Tool availability by tier”| Tool | Class | BASIC | INVESTOR | DEVELOPER |
|---|---|---|---|---|
search_companies | Free | Yes | Yes | Yes |
get_company | Free | Yes | Yes | Yes |
list_industries | Free | Yes | Yes | Yes |
get_risk_context | Free | Yes | Yes | Yes |
list_documents | Free | Yes | Yes | Yes |
get_account_quota | Free | Yes | Yes | Yes |
get_company_financials | Fact | 3 per day, TOPIX-99 only | Yes | Yes |
get_financial_facts | Fact | 3 per day, TOPIX-99 only | Yes | Yes |
get_calculation_tree | Fact | 3 per day, TOPIX-99 only | Yes | Yes |
get_segment_breakdown | Fact | 3 per day, TOPIX-99 only | Yes | Yes |
get_major_shareholders | Fact | 3 per day, TOPIX-99 only | Yes | Yes |
compare_companies | Fact | 3 per day, TOPIX-99 only (up to 3 companies per call) | Yes | Yes |
get_document_summary | Paid only | No | Yes | Yes |
analyze_document | Paid only | No | Yes | Yes |
screen_companies | Paid only | No | Yes | Yes |
get_industry_overview | Paid only | No | Yes | Yes |
The free allowance is shared by all fact tools on a BASIC account: 3 lookups per day in total, for TOPIX-99 companies only. It resets at 00:00 JST. This is a separate counter from the daily request limit, which resets at 00:00 UTC. All tools except get_account_quota count toward the daily request limit.
INVESTOR and DEVELOPER have identical tool access. The two tiers differ only in daily request quota — see MCP Overview for the quota table.
AI request limits
Section titled “AI request limits”get_document_summary (when the summary is not cached) and analyze_document share a daily AI request limit per account: 5 for BASIC, 20 for INVESTOR and 50 for DEVELOPER. The same counter also covers AI questions and chat replies in the web app. Cached summaries do not count. The daily AI budget applies across MCP and the web app for all tiers. On the web, BASIC accounts also keep the existing limit of 5 AI questions per month. The counter resets at 00:00 JST. When the limit is used, the tool returns an error with the code ai_budget_exhausted.
get_account_quota can be called up to 100 times per day. get_company_financials accepts periods from 1 to 10; larger values return a validation error.
See MCP Overview for tier details, Authentication for setup, and Resources Reference for the MCP resources exposed alongside these tools.