MCP

Every dataset in these docs is also available through the Model Context Protocol (MCP). Your assistant gets ten tools for companies, filings, statements, facts, metrics, ownership and events, and calls them when a question needs filing data.

Server URL

https://api.akkrudata.ai/mcp

#Connect your client

Clients sign you in with OAuth: sign in with the same AkkruData account you use for the dashboard (email and password, Google, or GitHub), review the connecting client, and click Authorize. Tokens renew automatically.

#Claude (web and desktop)

Open Customize → Connectors and click Add custom connector.
Enter https://api.akkrudata.ai/mcp as the server URL. If Claude asks how it should identify itself, choose Register automatically. Click Add.
Sign in with your AkkruData account when Claude asks, review the client, and click Authorize.

On Team and Enterprise plans, an Owner adds the connector under Organization settings → Connectors, and each member clicks Connect under Customize → Connectors.

#Claude Code

Shell

claude mcp add --transport http akkrudata https://api.akkrudata.ai/mcp

Then run /mcp inside Claude Code and finish sign-in in your browser.

#Cursor

Add the server to ~/.cursor/mcp.json, then sign in when Cursor prompts you.

JSON

{
  "mcpServers": {
    "akkrudata": { "url": "https://api.akkrudata.ai/mcp" }
  }
}

#Other clients

Add https://api.akkrudata.ai/mcp as a remote MCP server (custom connector) with OAuth, then sign in.

#Managing connections

List and disconnect any authorized assistant from Connected AI assistants in the dashboard. One account can hold up to 10 connections at a time.

#Tools

Tool	Data	Actions
`akkru_companies`	Find a company and see what is covered for it.	`search`, `lookup`, `list`
`akkru_filings`	The financial reports (10-K, 10-Q, 20-F, 40-F and their Korean, Japanese, Chinese and European equivalents) on file for a company.	`list`, `excel`
`akkru_statements`	Whole statements and notes of one filing, as filed: every row with its value, period, unit and source.	`get`, `list`
`akkru_facts`	Single reported numbers (and text facts) from filings, each with its period, unit, dimensions and a link to its place in the filing.	`get`, `breakdown`
`akkru_metrics`	82 metrics computed from each filing (margins, growth, leverage, efficiency, cash flow, valuation), each with its formula and the facts it used. US companies only. Starter plan or higher; formula_override needs Pro.	`get`, `history`, `list`, `catalog`, `search`
`akkru_insider_transactions`	Trades insiders report on SEC Form 4 (and Form 5), nested filing then transactions, with the insiders, footnotes and links to the filing. A trade's direction is its acquired_disposed_code (A or D). Rows failing a consistency check carry data_quality_flags and are left out unless include_anomalies is true; the count left out is reported.	`list`, `stats`, `get`, `insiders`, `types`, `tickers`, `search`
`akkru_initial_holdings`	What insiders report holding when they become insiders (SEC Form 3), nested filing then holdings; no_securities_owned true means the filer reported holding nothing. Rows failing a consistency check carry data_quality_flags and are left out unless include_anomalies is true.	`list`, `stats`, `get`, `insiders`, `tickers`, `search`
`akkru_institutional_holdings`	What institutional managers report holding each quarter on SEC Form 13F, by manager (filer CIK) and quarter. Links open the filing's EDGAR index page.	`managers`, `history`, `portfolio`, `holders`, `search`
`akkru_events`	Corporate events US companies report to the SEC, one section per Item (e.g. 5.02, officer changes), each with a summary and a link to its place in the filing; amendments are merged into the filing they amend. Starter plan or higher; results stop at your plan's history window.	`types`, `list`, `get`, `search`
`akkru_account`	Your account.	`balance`

#Calling a tool

Every tool takes action plus that action's parameters. Each tool's page lists its actions with their credits and every parameter with the actions that take it. A parameter set to null counts as not given.

JSON

{"action": "get", "ticker": "AAPL", "fiscal_year": 2025, "line_items": ["revenue"]}

detail is "full" (default), "light" or "minimal" on the actions that take it; all three are charged the same.

#Responses

A successful call returns the reply as JSON text without indentation. Read _warnings in every reply.

#Errors

A failed call returns isError: true with {"error": {...}}:

source

tool: the call was refused before any data was read, and nothing was charged. api: the request ran and returned an error.

code

A stable error code. For source api, the codes listed under Errors and each endpoint.

message

What is wrong.

status

HTTP status, for source api.

params, accepted

The parameters at fault, and the valid values or parameter names.

hint

The next step, when there is one.

Errors with source tool:

`code`	When
`TOOL_UNKNOWN`	No tool has that name.
`TOOL_PARAM_MISSING`	`action`, or one of the parameters the action needs, is missing.
`TOOL_PARAM_INVALID`	`action`, or a parameter that selects what the action returns, has a value outside `accepted`.
`TOOL_PARAM_NOT_ACCEPTED`	The action does not take the parameters in `params`.
`TOOL_PARAM_CONFLICT`	The parameters in `params` cannot be used together.
`INTERNAL_SERVER_ERROR`	The tool failed unexpectedly.

Other parameter values are checked when the request runs; a wrong value returns an error with source api.

#Credits and limits

Each action costs the credits its tool page shows, from your account's balance, under the account's rate limits (Credits & Rate Limits). Calls refused with source tool are not charged. akkru_account with action balance shows the credits left.