drillr.ai
API keys →

Install drillr MCP

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. Browser OAuth is the default authentication method; your client manages sign-in and stores the connection.

Set up your client

To install or connect drillr MCP, read the official installation guide. It covers setup, sign-in, and verification for your app. Client-specific references are below.

Connect with your agent

Paste this into your agent. The guide covers setup and browser sign-in for the app you are using.

Setup prompt
Please connect drillr MCP in this app using this installation guide: https://drillr.ai/developer/mcp-install.md. Walk me through sign-in and verify the connection.

Client-specific setup

Connection details for each client.

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

What happens next

  1. 1If the command starts OAuth, open its URL, sign in, and click Allow. Otherwise run codex mcp login drillr-data.
  2. 2If the tools are still unavailable after login, start a new session.
  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.

Filing Search

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.

Signals

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_search3 cr / call

Per call

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