Drillr — The financial MCP for AI agents

by Little-Grebe-Inc

5 stars

417 downloads

Not rated

GitHub Website

Finance

About

Drillr — the financial MCP for AI agents. Standardized financial data, SEC filings semantic search, live signals, and 24 alt-data categories.

Details

Author: Little-Grebe-Inc
GitHub stars: 5
Downloads: 417
Categories: Finance

- 9 tools covering financial data, SEC filings, company search, and signals
- Standardized financial data over 90+ tables (statements, ratios, earnings, insider, ownership)
- Paragraph-level semantic search over SEC filings (10-K, 10-Q, 20-F, etc.)
- Live cross-asset signal feed across ~6,900 tickers
- Ontology-based company discovery by business model, supply chain, or theme
- Global equities coverage: US and Japan (Hong Kong, A-shares, Korea coming soon)
- Alt-data for the AI value chain (energy, data centers, semiconductors, LLM pricing, etc.)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Drillr — The financial MCP for AI agents

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

From the repository

Sign up at drillr.ai, obtain an external-scope API key (format drl_xxxxxxxx_xxx..., 45 characters), then configure the server in your MCP host’s mcp.json using Streamable HTTP transport with a Bearer token header. Options include manual config, Smithery one-line install, or the Claude Code plugin.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "drillr \u2014 the financial mcp for ai agents": {
            "drillr": {
                "type": "http",
                "url": "https://gateway.drillr.ai/mcp/data",
                "headers": {
                    "Authorization": "Bearer ${DRILLR_API_KEY}"
                }
            }
        }
    }
}

McpServers

{
    "drillr": {
        "type": "http",
        "url": "https://gateway.drillr.ai/mcp/data",
        "headers": {
            "Authorization": "Bearer ${DRILLR_API_KEY}"
        }
    }
}

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

| Tool | Purpose |
| ------------------- | ---------------------------------------------------------------------------------------------------------------- |
| run_sql | Standardized financial data over 90+ tables — statements, ratios, earnings, insider, ownership, prices, alt-data |
| sec_report_search | Paragraph-level semantic search over 10-K / 10-Q / 20-F / 6-K / S-1 / DEF 14A filings |
| sec_report_list | List a ticker's indexed filings by form type and date range |
| company_search | Qualitative company discovery by description — business model, supply chain, peers, theme ("EV battery suppliers to Tesla") |
| signal_list | Live cross-asset signal feed across ~6,900 tickers |
| ticker_resolve | Resolve a company name / brand / ticker substring → canonical ticker (call first before any ticker-keyed tool) |
| list_tables | Discover available alt-data SQL tables by category |
| get_table_schema | Inspect columns and types for any SQL table |
| fiscal_utility | Fiscal-period helpers (FY/FQ resolution across companies with non-calendar years) |

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"> Drillr Discord QR </td>
<td align="center"> 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.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Drillr · The Financial Research Data Backend for Agents

Quick Start

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

Claude Code / Claude Agent SDK / Cursor / VS Code

Hermes Agent

Other hosts

Option B: Smithery one-line

Option C: Claude Code plugin

Hello World

One Toolkit, 9 Tools

What's Covered

REST API

Out of Scope

Community

License

Install

More like this

Stripe

Defeatbeta Api

MetaTrader MCP Server

EVM MCP Server

Polygon.io MCP Server

AI看线 - A股技术分析与AI预测工具