drillr

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: