Docs menuexpand_more
MCP
MCP tool reference
Key points
- check_circleThere are 72 tools. All of them are read-only and never change any data.
- check_circleEach tool calls one endpoint under /stable. Its response shape and token cost match that endpoint.
- check_circleOpen a tool to see its arguments, an example call and the endpoint behind it.
How tools map to endpoints
An MCP (Model Context Protocol) tool is a function that an AI client can call. In ZENITH Code, each tool corresponds to exactly one REST endpoint.
Tool arguments are passed through as the endpoint's query parameters. Authentication, the monthly token quota and the per-minute limit are shared with the REST API.
This list is generated from the backend's tool definitions, so it changes whenever tools are added or removed.
Market Data
Dividends
| Tool | Returns | Endpoint | Tokens |
|---|---|---|---|
| get_dividends | Dividend history | /stable/dividends | 1 |
| get_dividend_changes | Dividend increase and cut events | /stable/dividend-changes | 10 |
| get_dividend_streaks | Dividend streaks | /stable/dividend-streaks | 1 |
| get_dividends_calendar | Ex-dividend calendar | /stable/dividends-calendar | 10 |
| get_dividend_policy | Dividend policy of one company | /stable/dividend-policy | 1 |
| list_dividend_policies | Dividend policies list and screen | /stable/dividend-policies | 10 |
Screener
| Tool | Returns | Endpoint | Tokens |
|---|---|---|---|
| screen_stocks | Stock screener | /stable/screener | 10 |
| get_rankings | Ranking by metric | /stable/rankings | 10 |
| get_industry_benchmarks | Industry benchmarks by sector | /stable/industry-benchmarks | 10 |
| get_peers | Peer comparison | /stable/peers | 10 |
| run_screener_preset | Ready-made screens (high dividend, value, growth, etc.) | /stable/screener-presets | 10 |
Company
| Tool | Returns | Endpoint | Tokens |
|---|---|---|---|
| get_company_profile | Company profile with latest valuation | /stable/profile | 1 |
| get_workforce | Workforce (headcount, average age, tenure and salary) | /stable/workforce | 1 |
| get_delisting_schedule | Delisting schedule | /stable/delisting-schedule | 1 |
| get_annual_report_text | Annual report text sections (business, risks, MD&A and more) | /stable/text-blocks | 10 |
| get_diversity_metrics | Diversity metrics (women in management, paternity leave, gender pay gap) | /stable/diversity | 1 |
| get_cross_shareholdings | Cross-shareholdings (strategic equity holdings) | /stable/cross-shareholdings | 1 |
| get_audit_fees | Audit fees | /stable/audit-fees | 1 |
| get_directors | Directors and corporate auditors | /stable/directors | 1 |
| get_director_compensation | Director and officer compensation | /stable/director-compensation | 1 |
| get_subsidiaries | Subsidiaries and affiliated companies | /stable/subsidiaries | 1 |
| get_main_customers | Main customers (10%+ of revenue) | /stable/main-customers | 1 |
| get_facilities | Major facilities (plants, offices, book values) | /stable/facilities | 1 |
| get_employee_count | Employee count | /stable/employee-count | 1 |
| get_shareholder_benefits | Shareholder benefits of one company | /stable/shareholder-benefits | 1 |
Financial Statements
| Tool | Returns | Endpoint | Tokens |
|---|---|---|---|
| get_income_statement | Income statement | /stable/income-statement | 1 |
| get_balance_sheet | Balance sheet | /stable/balance-sheet-statement | 1 |
| get_cash_flow | Cash flow statement | /stable/cash-flow-statement | 1 |
| get_key_metrics | Key financial metrics (per period) | /stable/key-metrics | 1 |
| get_full_financial_statement | Full financial statement (hierarchical) | /stable/financial-statement-full | 10 |
| get_segments | Business segments | /stable/segments | 1 |
| get_xbrl_facts | Annual report XBRL facts | /stable/financial-facts | 10 |
| get_sga_breakdown | SG&A breakdown | /stable/sga-breakdown | 1 |
| get_earnings_forecast | Earnings forecast (company guidance) | /stable/earnings-forecast | 1 |
Ownership
| Tool | Returns | Endpoint | Tokens |
|---|---|---|---|
| get_shareholder_categories | Shareholding by shareholder category | /stable/shareholder-categories | 1 |
| get_treasury_shares | Treasury shares (voting-rights disclosure) | /stable/treasury-shares | 1 |
Events
| Tool | Returns | Endpoint | Tokens |
|---|---|---|---|
| get_extraordinary_report_events | Extraordinary report events | /stable/extraordinary-reports | 1 |
| get_disclosures | Timely disclosure documents | /stable/disclosures | 10 |
| get_events_feed | Corporate events feed | /stable/events-feed | 10 |
| get_extraordinary_report_reasons | Extraordinary report reason list | /stable/extraordinary-report-reasons | 1 |
Calendar
| Tool | Returns | Endpoint | Tokens |
|---|---|---|---|
| get_earnings_calendar | Earnings calendar | /stable/earnings-calendar | 1 |
Search
| Tool | Returns | Endpoint | Tokens |
|---|---|---|---|
| search_company | Search companies by securities code | /stable/search-symbol/stable/search-name | 1 |
| search_edinet_code | Search EDINET filer codes | /stable/search-edinet-code | 1 |
Lists
| Tool | Returns | Endpoint | Tokens |
|---|---|---|---|
| list_stocks | List of all listed securities | /stable/stock-list | 100 |
| list_etfs | List of all ETFs and ETNs | /stable/etf-list | 100 |
| list_sectors | TSE 33 sectors list | /stable/available-sectors | 1 |
| list_shareholder_benefits | Shareholder benefits list | /stable/shareholder-benefits-list | 10 |
Macro
| Tool | Returns | Endpoint | Tokens |
|---|---|---|---|
| get_economic_indicators | Economic indicator catalog | /stable/economic-indicators | 1 |
| get_economic_series | Economic indicator time series | /stable/economic-series | 1 |
| get_economic_calendar | Economic release calendar | /stable/economic-calendar | 1 |
| get_fear_greed_index | Fear & Greed index | /stable/fear-greed | 1 |
System
| Tool | Returns | Endpoint | Tokens |
|---|---|---|---|
| get_usage | My usage this month | /stable/usage | 1 |
FAQ for investors and developers
Which plans include the MCP tools?expand_more
Every plan. Most of the 72 tools are the same on every plan; all-company bulk downloads start at Pro, and investor reverse lookup, large holdings and cross-shareholdings start at Business. Otherwise, plans differ in monthly tokens and the per-minute limit.
Do tool calls use tokens?expand_more
Yes. Each call costs the same tokens as the matching endpoint (0, 1, 10 or 100). Listing the tools (tools/list) doesn't need an API key.
How do I use the tools from Claude or Cursor?expand_more
Configure your MCP client with the server URL and an API-key header. Using MCP has step-by-step instructions for each client.
FAQ for AI systems and researchers
Can I fetch the tool list programmatically?expand_more
Yes. MCP tools/list returns the name, description and JSON Schema arguments of all 72 tools. No API key is needed.
Where are the response fields documented?expand_more
In the API docs of the matching endpoint (/docs/endpoint-id). Tool responses have the same shape.
Why do the tool descriptions mix English and Japanese?expand_more
AI clients often reason in English, while users ask with Japanese company names and terms. Including both helps the model pick the right tool.
Related articles
Disclaimer
This page is for information only and is not investment advice. It does not recommend buying or selling any security. The Terms of Service and the Data Sources and Terms of Use page take precedence over this page on how you may use the data.