Financial data is informational and may be inaccurate. See Disclaimer.

drillr.ai
API keys →

MCP server

The same financial data as 10 tools your agent can call directly. No key to paste — MCP clients sign in through the browser.

What it is

Model Context Protocol is how an agent discovers and calls tools. Point a client at the endpoint below and drillr’s tools appear inside it — the agent decides which to call, and the answers come back with the filings and tables they came from.

https://gateway.drillr.ai/mcp/data

Streamable HTTP transport. Authentication is browser OAuth: the first call opens a sign-in page, and the client keeps the grant afterwards.

Set up your client

Pick what you are holding. Every client below connects to the same server with browser sign-in; no key to paste.

Let your coding agent do it

Paste this into whatever you already have open — Claude Code, Codex, Cursor, anything with a shell. It works out which client it is and walks you through the browser sign-in.

Setup prompt
Please install the drillr MCP server for me and walk me through the sign-in: server drillr-data, url https://gateway.drillr.ai/mcp/data, auth browser OAuth.

Use my client's own MCP command to add it (claude mcp add / codex mcp add / my editor's MCP config — whichever applies to you). Then tell me the steps that are mine: MCP tools only load at startup so I'll need to restart, and the browser Allow click is mine to make. Per-client details if you want them: https://drillr.ai/developer/mcp-install.md Reply in the language I'm using with you.

Or set it up yourself

The command, config, and steps for each client.

Terminal
codex mcp add drillr-data --url https://gateway.drillr.ai/mcp/data

What happens next

  1. 1The command prints an authorization URL and waits — open it, sign in, click Allow.
  2. 2Exit Codex and start a new session. MCP tools load at startup.
  3. 3Ask “Use drillr-data to look up the ticker for Apple” to confirm it works. That call is free.
If it exits without authenticating
codex mcp login drillr-data

No API key is required for drillr-data. Your client opens drillr in the browser; sign in if needed, review the named client, and click Allow.

Tools

10 tools. Between them they cover discovery, filings, signals and arbitrary SQL over the financial tables — which is why the set stays small: the agent composes them rather than picking from fifty.

Company

2 tools

Turn a name or a description into tickers. Every other tool wants a ticker.

TOOLticker_lookupResolve a company name, brand or ticker substring to canonical symbols, historical names included.TOOLcompany_searchFind companies by natural-language description — industry, product, business model, supply-chain position.

Filings

2 tools

US, CN and JP company-filed reports. List first, then search.

TOOLfiling_listWhich filings are indexed for a ticker — fiscal period, type, filing date — before you search inside them.TOOLfiling_searchSearch one company’s filings and get two partitions in one call: structured as-reported facts, and the filing text itself.

Datasets

3 tools

Read-only SQL over the financial, market and alt-data tables. Discover, inspect, then query. The core equity tables reach US, CN and JP; specialized tables can be narrower, and each one states its own coverage.

TOOLlist_tablesThe alternative-data tables under a category — name, purpose and column names — or the category index when called bare.TOOLget_table_schemaOne table’s columns and types, with its usage note — required filters, coverage, gotchas. Read it before writing SQL.TOOLrun_sqlA read-only PostgreSQL SELECT over the financial, market and alt-data tables.

Signal

3 tools

Company and market signals from structured earnings-call research and news.

TOOLindustry_inflectionsSearch industry inflections identified through structured research of earnings calls held by US-listed companies after July 2026, including the change mechanism, impact scope, market attention and affected companies.TOOLai_adoptionSearch concrete enterprise AI applications disclosed in US company earnings calls from September 2023 to the present, filtered by ticker, company name, application name or update date.TOOLnews_searchSemantic search over company and market news — storylines, the events inside them, and attributed statements.

What to ask

You do not call the tools yourself; you ask the agent and it does. Questions that work well are the ones a junior analyst could act on:

  • “What does NVDA’s latest 10-Q say about supply commitments?”
  • “Japanese manufacturers with net cash and rising free cash flow.”
  • “Compare gross margin across the three largest memory makers, last eight quarters.”
  • “Which companies disclosed an auditor change this quarter?”

Errors

A failed call reaches your client in one of four shapes. Each tool’s page says which shape its own failures take, and what the message means.

Invalid arguments
JSON-RPC error -32602 before the tool runs, listing each bad field. Not charged.
Credits exhausted
JSON-RPC error -32001 before the tool runs, with balance and pricing link. Not charged.
Tool failure
The tool ran and could not answer: a result marked isError whose text is the message.
Service unavailable
JSON-RPC error -32002 — a backend is down. Retry later. Not charged.

Per-tool rates

REST and MCP draw from the same credits wallet. Requests rejected before data retrieval are not charged; see Pricing for plans and current credit options.

ticker_lookup0

Free

company_searchTypically 3–5 cr / call

Usage-based

filing_list0.1 cr / call

Per call

filing_search0.1 cr / call

Per call

list_tables0

Free

get_table_schema0

Free

run_sql0.1 cr / call

Per call

industry_inflections1 cr / call

Per call

ai_adoption1 cr / call

Per call

news_search0.2 cr / call

Per call