Docs/Surfaces/MCP server
Surfaces

MCP Server

Axiora speaks MCP, so an AI agent can query it directly, 41 read-only tools over the same EDINET-sourced data as the REST API. Point a client at one URL, use your existing key, and the model calls the tools itself.

What it is

Every tool is read-only: an agent reads data, never writes or changes it. They run on the same backend and the same key as the REST API, so what an agent reports back is exactly what the API returns.

Use MCP when you want a model to do the querying; use REST when your own code does. Same data either way.

Endpoint & transport

Point any MCP-compatible client at the endpoint below. The transport is Streamable HTTP.

EndpointTransport
https://api.axiora.dev/mcpStreamable HTTP

Authentication

Authentication uses the same Bearer token as the REST API, passed in the Authorization header. The MCP server needs a Developer or Institutional key.

Header
Authorization: Bearer ax_live_•••
i
The same key as REST

MCP needs no separate key. It uses the same ax_live_ token as REST. See Authentication for how to get one and what each tier unlocks.

Connect a client

With Claude Code you can add the server in one line:

Claude Code
claude mcp add --transport http axiora \
  https://api.axiora.dev/mcp \
  --header "Authorization: Bearer ax_live_YOUR_KEY"

For other clients (Claude Desktop, Cursor, …) add the server to your MCP config (e.g. claude_desktop_config.json or .cursor/mcp.json):

mcp.json
{
  "mcpServers": {
    "axiora": {
      "type": "url",
      "url": "https://api.axiora.dev/mcp",
      "headers": {
        "Authorization": "Bearer ax_live_YOUR_KEY"
      }
    }
  }
}

Then just ask, “Show me Toyota's financials”, and the agent chains the tools itself: search_companies → get_financials.

Tools

All 41 tools, with descriptions generated straight from the live server, so this table can't drift from what the agent can actually call. You don't invoke these yourself; the agent picks one per question.

ToolDescription
compare_companiesCompare financials of 2-5 companies side by side
get_activist_campaignsGet detected activist campaigns in Japanese companies
get_board_compositionGet board composition and officer list for a company
get_buybacksGet share buyback reports for a company
get_capital_allocationGet capital allocation classification for a company
get_capital_allocation_rankingRank companies by capital allocation classification
get_companyGet detailed info for a single company
get_company_relationshipsGet unified relationship graph for a company
get_coverageGet data coverage statistics — totals, metric availability, freshness
get_cross_holdingsGet cross-shareholding pairs (持ち合い株 / 政策保有株)
get_documentationGet Axiora API documentation, metric definitions, and usage guide
get_earningsGet earnings snapshots from TDNet 決算短信 for a company
get_earnings_signalsGet earnings signals detected from 決算短信 data
get_field_definitionsGet field definitions from the financial data ontology
get_filing_calendarGet filing calendar for a month — how many filings per day
get_financialsGet financial time series for a company
get_forecastsGet management guidance, revisions and their sources in one company flow
get_growthGet year-over-year growth rates and CAGRs for a company
get_health_rankingRank companies by financial health score
get_health_scoreGet the financial health score (0-100) for a company
get_ownership_moversGet market-wide biggest ownership moves
get_ownership_signalsGet detected ownership signals
get_ownership_trajectoriesGet ownership trajectories for a company
get_peersFind peer companies in the same sector with similar revenue
get_probability_tableGet the conditional completion table for ownership trajectories
get_rankingGet a ranking of companies by financial metric
get_sectionsGet text sections from a company's annual filing (MD&A, risk factors, etc.)
get_sector_overviewList sectors with company counts, or get stats for a specific sector
get_shareholding_auditFull audit bundle for a single shareholding row
get_shareholdingsGet large shareholding reports for a company
get_signal_definitionsGet skill definitions: what each signal, score and classification means
get_subsidiariesGet all subsidiaries this company has disclosed in 関係会社
get_timeseriesGet time-series data for a financial metric across companies
get_translationsGet English translations of a Japanese filing
get_unwinding_scoreboardGet cross-holdings that are being unwound
get_voting_resultsGet AGM voting results for a company
list_filingsList filings with optional filters
screen_companiesScreen companies by financial criteria
search_companiesSearch for Japanese listed companies by name or code
search_companies_batchLook up multiple companies at once by code or name
search_translationsFull-text search across English translations of Japanese filings