🌐 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.

One API key. Nine tools for agent research: standardized financial data, company discovery, semantic news and event search, paragraph-cited company filings, and 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. A Bearer API key is the recommended setup. Clients with MCP OAuth support can instead omit the headers block and complete the browser sign-in flow.

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

• Core equity coverage: US, Japan, Hong Kong, and China A-shares. Ticker formats: AAPL, 6758.T, 00700.HK, 600519.SH / 300750.SZ.
• Ontology-based Company Search: Search over the universe of equities with business model descriptions, supply chain positions, growth vector or thematic fit.
• Fundamentals: financial_statements, company_snapshot, and price_volume_history cover all four core markets; financial history reaches back to the 1980s
• Company filings: SEC EDGAR, Japan EDINET, HKEX, and China A-share reports with paragraph-level semantic search
• Earnings: call transcripts with AI-structured summaries and estimate-vs-actuals history; this specialized dataset covers US + Japan
• Markets: equities, ETFs, indices, forex, crypto, commodities
• Specialized US datasets: analyst ratings, ownership, executives, 8-K events, and extended-hours quotes
• News + events: continuously updating four-market and cross-asset search with story grouping and attributed claims
• 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.

License

MIT — see LICENSE.