How do I install Drillr — The Financial MCP For AI Agents?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Drillr — The Financial MCP For AI Agents need an API key?

No required environment variable is listed on this record.

What transport does Drillr — The Financial MCP For AI Agents use?

Drillr — The Financial MCP For AI Agents is reached over HTTP.

When was Drillr — The Financial MCP For AI Agents last checked?

Last checked 2026-10-18. Financial data and research MCP for US/CN/JP equities: filings, statements, ownership, signals.

Drillr — The Financial MCP For AI Agents MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

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

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http ai.drillr-drillr https://gateway.drillr.ai/mcp/data

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "ai.drillr-drillr": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://gateway.drillr.ai/mcp/data"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 2.3.0
Last checked

10 tools

Tools

tools/listVoice mode preview

Tool	What it does
filing_list	Use to discover which SEC filings exist for a ticker before searching content. For the actual content use filing_search instead. List indexed SEC filings for a given ticker with a summary header. Returns: summary (period coverage, per-type counts) + table of up to 50 filings (fiscal_year, fiscal_q
filing_search	Search one company's SEC filings. Returns `## Facts` (exact as-reported and restated financial values) and `## Passages` (matching filing text) — both come back in one call. `ticker` is REQUIRED. When `## Facts` is empty, read `## Passages` — the figure is usually stated in the filing text. `perio
company_search	Use for qualitative company discovery (industry, business model, supply chain, competitors, management background). For numerical screening (revenue, margins, ratios, growth rates) use run_sql on company_snapshot instead. Drillr's company knowledge graph — searchable across industry classification,
ticker_lookup	Resolve a company name, brand, or ticker substring to canonical ticker(s). Input: - query (required): company name, brand, or ticker substring, e.g. "Apple", "AAPL", "OpenAI" - market (optional): "us" \| "jp" \| "cn" — omit to search all markets Returns up to 5 matches ranked by prefix-hit first, th
run_sql	PostgreSQL SELECT over financial / market / alt-data tables — returns structured rows. Hard rules (query fails otherwise): - SELECT only, no CTE (`WITH ... AS`) — use subqueries. - Period columns are TEXT, not dates — `period_end` is 'YYYY-MM'. Compare as strings (`period_end >= '2024-01'`); a `::d
get_table_schema	Column definitions (name, type, description) for a data table, plus its usage note where one exists: required filters, ticker format, and market coverage.
list_tables	List alternative-data tables under the given categories. Returns each table's name, one-line purpose, and column names (call get_table_schema if you need column types/comments). Batch up to 5 categories in one call; omit categories, or pass ["all"], to get the category index instead. Use this BEFOR
news_search	Use for any news, event, development, or statement question about a company, theme, or the market. The `ticker` filter takes exchange-suffixed symbols. Returns Markdown: a `## Stories` numbered list (each storyline once), then flat `## Events` and `## Claims` tables (claims = attributed statements:
industry_inflections	Search industry inflections identified through structured research of earnings calls held by US-listed companies, including the change mechanism, impact scope, market attention and affected companies. All filters are optional and combine with AND. With no filters, returns the newest first page. Res
ai_adoption	Search concrete enterprise AI applications disclosed in US company earnings calls. Filter by ticker, partially match a company name, search for an application or workflow by name, or use since in YYYY-MM-DD format to include only observations updated on or after that date. Returns a data array order

🌐 English · 中文

drillr · The financial data and research MCP for AI agents

Filings, statements, earnings, ownership, events, executives, analyst data, company discovery and research signals for US, China and Japan equities — every figure traced to the document it came from.

Browser sign-in, no API key to copy. One hosted Streamable HTTP endpoint, ten tools: turn a name or a description into tickers, list and search a company's filings (structured as-reported facts and the filed text), run read-only SQL over the financial tables, and pull research signals from earnings calls and news.

⭐ If drillr helps your agent, star us — that's how we know to keep building this in the open.

Install drillr MCP

To install or connect drillr MCP, read the official installation guide. It is the maintained source for client-specific setup, browser OAuth sign-in, and connection checks.

Paste this into the app where you want to use drillr:

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.

The public server is drillr-data at https://gateway.drillr.ai/mcp/data (Streamable HTTP). Browser OAuth is the default. The guide covers client-specific requirements and the API-key fallback for clients without OAuth support.

For manual setup and tool reference, see drillr.ai/docs/mcp.

Agent skill

The companion drillr skill adds research workflows for MCP and REST. Installing the skill is optional for connecting the MCP server:

npx skills add Little-Grebe-Inc/drillr-skill

Distribution options

Smithery listing
This repository also provides a Claude Code plugin marketplace:

/plugin marketplace add Little-Grebe-Inc/drillr-mcp-server
/plugin install drillr

After installing a plugin, use the official guide for sign-in and verification in the selected client.

Hello World

"What does NVDA's latest 10-K say about supply commitments, and how did data-center revenue move over the last four quarters?"

The agent calls ticker_lookup if it only has a name, filing_list to see what is indexed, then filing_search — which returns as-reported facts (value, period, XBRL concept, accession number) and the passages they sit in, in one call.
For the quarterly series it calls run_sql on financial_statements.
You get an answer whose every number cites its filing. Typical round-trip 8–15 s.

The ten tools

Each tool has a page at https://drillr.ai/docs/mcp/<tool> with parameters, limits and error shapes; the server's tools/list carries the same descriptions. The set stays small on purpose: the agent composes them.

Group	Tool	What it does	Cost
Company	`ticker_lookup`	Name, brand or ticker substring → canonical symbols, historical names included	free
	`company_search`	Natural-language description → companies with a match reason; US / CN / JP / HK / KR; all matches returned	3–5 cr
Filings	`filing_list`	Which filings are indexed for a ticker: fiscal period, type, filing date	0.1 cr
	`filing_search`	Search one company's filings; returns structured as-reported facts and the filing text together	0.1 cr
Datasets	`list_tables`	Alt-data category index, or the tables under up to five categories	free
	`get_table_schema`	One table's columns, types and usage note — required filters, coverage, gotchas	free
	`run_sql`	One read-only PostgreSQL SELECT over the financial, market and alt-data tables	0.1 cr
Signal	`industry_inflections`	Industry changes synthesized from many US earnings calls: mechanism, scope, degree, per-company impact	1 cr
	`ai_adoption`	Concrete enterprise AI applications disclosed on US earnings calls: workflow, stage, value, evidence	1 cr

What the data is

Built by drillr from primary sources — filings taken from each market's official channel (SEC EDGAR, cninfo, EDINET) and parsed in house, what companies publish on the web (IR pages, earnings calls, news), and drillr's own estimates. No data vendor in between. Every reported figure links back to the passage it was filed in. Provenance per dataset: https://drillr.ai/docs/provenance.

Dataset	What is in it	How to reach it	Coverage
Company	Ticker resolution from any name, code, ISIN, CIK or CUSIP; discovery by description; profile (exchange, industry, listing date, website, headcount)	`ticker_lookup`, `company_search`; `company_snapshot` via SQL	US CN JP (discovery + HK KR)
Filings	Filing index with form type, date and official link; full-text search in EN / ZH / JA; as-reported fact records with value, unit, period, filing and position, linked in a knowledge graph so the right version of a figure wins	`filing_list`, `filing_search`	US CN JP
Financials	Income statement, balance sheet, cash flow as reported under each market's standard, annual and quarterly; precomputed valuation, margin, return, growth, leverage and liquidity metrics	`run_sql` on `financial_statements`, `company_snapshot`	US JP HK CN KR
Prices	Daily / weekly / monthly OHLCV, indices, pre- and after-market quotes	`run_sql` on `price_volume_history`, `index_price`, `equity_extended_rt`	equities US JP HK CN KR; indices, FX, crypto, commodities
Earnings	Calendar with estimates and actuals; structured call summaries (highlights, guidance, risks, segments, Q&A)	`run_sql` on `earning_call_calendar`, `earning_call_summary`	US JP
Ownership	Insider holdings and transactions (Forms 3 / 4 / 5); institutional quarterly positions (13F-HR)	`run_sql` on `insider_and_institution_activities`	US
Events	8-K corporate events: executive changes, deals, debt issuance, securities offerings; 13D / G stake changes	`run_sql` on `executive_change`, `company_deal_events`, `debt_issuance`, `securities_offering`	US

Ticker forms: US bare (AAPL), A-shares .SH / .SZ (600519.SH), Japan .T (6758.T), Hong Kong .HK (00700.HK), Korea .KS / .KQ (005930.KS); indices ^GSPC; quote symbols with . or ^ in SQL. Freshness: filings, ownership and events within minutes of the filing; calls and news within minutes to hours; statements and analyst data daily.

Benchmark: the drillr MCP-powered model scores 94.06 % on Vals Finance Agent, and drillr publishes its own restatement-aware benchmark — https://drillr.ai/drillr-benchmark.

REST API

The same data as 29 typed REST endpoints for scripts and pipelines — one X-API-KEY header, JSON out, public OpenAPI 3.1 contract:

curl -H "X-API-KEY: $DRILLR_API_KEY" \
  "https://gateway.drillr.ai/api/v2/income-statements?ticker=AAPL&period=FY&limit=4"

Reference: https://drillr.ai/docs/api · Contract: https://gateway.drillr.ai/api/v2/openapi.json. The older /api/v1/data/* tool mirrors are documented in docs/rest-api.md.

Pricing and limits

One credit wallet across MCP and REST. Free: 80 credits on sign-up. Plus $29 / 300 cr per month, Ultra $99 / 1,500 cr, Enterprise for redistribution and SLA. run_sql returns 100 rows (500 on Ultra), 10 s per statement, 5 in flight; company_search is capped per day (20 / 100 / 500). Failed calls are not billed. https://drillr.ai/pricing

Out of scope

Private or unlisted companies · on-chain crypto metrics (CEX prices only) · options chains, order book, tick data · placing orders · drillr does not produce its own price forecasts.

Community

License

MIT — see LICENSE.

Drillr — The Financial MCP For AI Agents

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Drillr — The Financial MCP For AI Agents?

Does Drillr — The Financial MCP For AI Agents need an API key?

What transport does Drillr — The Financial MCP For AI Agents use?

When was Drillr — The Financial MCP For AI Agents last checked?

Documentation

drillr · The financial data and research MCP for AI agents

Install drillr MCP

Agent skill

Distribution options

Hello World

The ten tools

What the data is

REST API

Pricing and limits

Out of scope

Community

License