<div align="center">

🌐 English · 中文

Drillr · The Financial Research Data Backend for Agents

The financial MCP for AI agents. Scan markets. Build conviction. Track every signal. Cite every claim.

</div>

One API key. Five tools for every research workflow: thesis search engine, standardized financial data (statements, ratios, earnings, insider, ownership), live signals, paragraph-cited SEC filing search, alt-data.

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

Quick Start

1. Sign up at drillr.ai
2. Get an external-scope API key (format drl_xxxxxxxx_xxx..., 45 chars) at drillr.ai/developer/keys — you'll paste this into the config below
3. Drop into your host's mcp.json — one endpoint exposes all the tools below.

Option A: Manual mcp.json (any MCP host — recommended)

#### Claude Code / Claude Agent SDK / Cursor / VS Code

{
  "mcpServers": {
    "drillr": {
      "type": "http",
      "url": "https://gateway.drillr.ai/mcp/data",
      "headers": { "Authorization": "Bearer <YOUR_DRILLR_API_KEY>" }
    }
  }
}

⚠️ Replace `<YOUR_DRILLR_API_KEY>` (including the angle brackets) with the drl_* key you got in step 2. Power users on Claude Code / Cursor / VS Code can use ${DRILLR_API_KEY} instead and export DRILLR_API_KEY=drl_... in the shell launching the host.

For Cursor, paste the block into ~/.cursor/mcp.json. For VS Code (GitHub Copilot Chat), run MCP: Add Server from the Command Palette and paste the block. Or use one-click install:

After install, replace ${DRILLR_API_KEY} in the generated config with your real drl_* key.

#### Hermes Agent

mcp_servers:
  drillr:
    url: 'https://gateway.drillr.ai/mcp/data'
    headers: { Authorization: 'Bearer <YOUR_DRILLR_API_KEY>' }

#### Other hosts

Any MCP-compatible host (OpenClaw, ChatGPT MCP, etc.) — same Streamable HTTP transport, same Bearer header. Authentication is Bearer API key only.

Option B: Smithery one-line

npx -y @smithery/cli install drillr/drillr --client claude

Smithery prompts for your drl_* API key on first install and writes it into your client's mcp.json automatically.

Listing: https://smithery.ai/servers/drillr/drillr

Option C: Claude Code plugin

This repo doubles as its own single-plugin marketplace. From Claude Code:

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

Then set DRILLR_API_KEY in your environment (or paste it into the generated config) and you're done.

Hello World

Once configured, ask your agent something like:

_"Pull NVDA's last 10-Q gross margin and compare it to AMD's same quarter — flag any divergence in segment mix."_

What happens under the hood:

1. Your host routes the question to the drillr MCP server
2. The agent picks the right tools — typically sec_report_search (10-Q content) and run_sql (financial_statements for margins)
3. You get back a markdown answer with sources cited, typically in 8-15 seconds
4. Check your remaining credit balance at drillr.ai/developer/keys; REST clients additionally get an inline { "data": ..., "_credits": ... } envelope on every 2xx (see REST API › Response Envelope) — MCP responses follow standard JSON-RPC and do not carry per-call credit info inline

One Toolkit, 9 Tools

drillr exposes a single MCP endpoint with 9 tools — an all-in-one toolkit for most financial research workflows:

Full tool reference: docs/tools.md.

What's Covered

• Global equities: US + Japan. Hong Kong / A-shares / Korea native listings coming soon.
• Ontology-based Company Search: Search over the universe of equities with business model descriptions, supply chain positions, growth vector or thematic fit.
• Fundamentals: financials back to the 1980s, 90+ structured tables (income statement, balance sheet, cash flow, ratios, growth, valuation)
• SEC filings: 10-K / 10-Q / 20-F / 6-K / S-1 / DEF 14A with paragraph-level semantic search
• Earnings: call transcripts with AI-structured summaries (guidance, risks, segments, Q&A), full estimate-vs-actuals history
• Markets: equities, ETFs, indices, forex, crypto, commodities
• Analyst coverage: rating events and consensus from major sell-side firms
• News + signals: continuously-updating cross-asset feed (equities, macro, geopolitics, commodities, crypto)
• AI value chain alt-data: energy & power, data centers, semiconductors, compute pricing, AI models / companies / benchmarks, LLM token pricing, macro & trade, prediction markets, critical minerals

Full data dictionary: docs/tools.md.

REST API

Every MCP tool has a 1:1 REST endpoint. Same drl_* key, same data, same billing. See docs/rest-api.md.

curl -X POST https://gateway.drillr.ai/api/v1/data/run_sql \
  -H "Authorization: Bearer $DRILLR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sql":"SELECT ticker, close FROM price_volume_history WHERE ticker='\''AAPL'\'' AND time_frame='\''daily'\'' ORDER BY period_end DESC LIMIT 5"}'

Out of Scope

We're upfront about edges so your agent doesn't waste research loops:

• Private / unlisted companies (we cover public-listed only)
• On-chain crypto metrics — we have CEX prices (BTCUSD / ETHUSD / SOLUSD etc.), not TVL / holders / wallets
• Options chains, real-time order book, intraday tick data
• Retail brokerage actions (placing orders, managing positions)
• drillr does not produce its own price forecasts — we surface analyst consensus

Community

Building something with drillr, hit a rough edge, or want early-access drops? Come say hi — scan to join, or click the heading link.

<table> <tr> <td align="center" width="50%"><a href="https://discord.gg/YAh96nw5Vh"><b>Discord</b></a></td> <td align="center" width="50%"><b>WeChat</b></td> </tr> <tr> <td align="center"><img src="https://gateway.drillr.ai/qr/discord.svg" width="160" alt="Drillr Discord QR" /></td> <td align="center"><img src="https://gateway.drillr.ai/qr/wechat.svg" width="160" alt="Drillr WeChat group QR" /></td> </tr> <tr> <td align="center">Devs building agentic research products — office hours, debugging help, early access.</td> <td align="center">Chinese-speaking dev community — fastest product feedback.</td> </tr> </table>

License

MIT — see LICENSE.