# Drillr β€” The financial MCP for AI agents [Health: Active] **Category:** πŸ’° Finance & Fintech **Repository:** https://github.com/Little-Grebe-Inc/drillr-mcp-server **GitHub Stars:** 6 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/drillr-the-financial-mcp-for-ai-agents ## Description The financial MCP for AI agents - 90+ financial tables, SEC filings, signals, alt-data. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "drillr-the-financial-mcp-for-ai-agents": { "command": "npx", "args": ["-y","@smithery/cli"] } } ``` ## Documentation & README
🌐 **English** Β· [δΈ­ζ–‡](./README.zh-CN.md) # Drillr Β· The Financial Research Data Backend for Agents The financial MCP for AI agents. Scan markets. Build conviction. Track every signal. Cite every claim. [![License](https://img.shields.io/badge/License-MIT-0969DA?style=flat)](./LICENSE) [![MCP](https://img.shields.io/badge/MCP-Streamable_HTTP-F97316?style=flat)](https://modelcontextprotocol.io) [![Tools](https://img.shields.io/badge/πŸ› _Tools-2EA44F?style=flat)](./docs/tools.md) [![REST API](https://img.shields.io/badge/πŸ”§_REST_API-0EA5E9?style=flat)](./docs/rest-api.md) [![Docs](https://img.shields.io/badge/🌐_Docs-8B5CF6?style=flat)](https://drillr.ai/developer/docs) [![Issues](https://img.shields.io/badge/πŸ’¬_Issues-EC4899?style=flat)](https://github.com/Little-Grebe-Inc/drillr-mcp-server/issues)
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](https://drillr.ai) 2. Get an `external`-scope API key (format `drl_xxxxxxxx_xxx...`, 45 chars) at [drillr.ai/developer/keys](https://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 ```jsonc { "mcpServers": { "drillr": { "type": "http", "url": "https://gateway.drillr.ai/mcp/data", "headers": { "Authorization": "Bearer " } } } } ``` > ⚠️ **Replace ``** (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: [![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-171717?style=for-the-badge&logo=cursor&logoColor=white)](https://cursor.com/en/install-mcp?name=drillr&config=eyJ1cmwiOiJodHRwczovL2dhdGV3YXkuZHJpbGxyLmFpL21jcC9kYXRhIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7RFJJTExSX0FQSV9LRVl9In19) [![Install in VS Code](https://img.shields.io/badge/Install_in-VS_Code-0078D4?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=drillr&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//gateway.drillr.ai/mcp/data%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24%7BDRILLR_API_KEY%7D%22%7D%7D) After install, replace `${DRILLR_API_KEY}` in the generated config with your real `drl_*` key. #### Hermes Agent ```yaml mcp_servers: drillr: url: 'https://gateway.drillr.ai/mcp/data' headers: { Authorization: 'Bearer ' } ``` #### 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 ```bash 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](https://drillr.ai/developer/keys); REST clients additionally get an inline `{ "data": ..., "_credits": ... }` envelope on every 2xx (see [REST API β€Ί Response Envelope](./docs/rest-api.md#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 across company filings in the US, Japan, Hong Kong, and China A-shares | | `sec_report_list` | List a ticker's indexed filings by filing type | | `company_search` | Four-market qualitative discovery by business model, supply chain, peers, or theme | | `news_search` | Semantic search over news, market events, and attributed claims, grouped into storylines | | `ticker_lookup` | Resolve a company name, brand, or ticker substring to ticker history | | `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`](./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`](./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`](./docs/rest-api.md). ```bash 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.
Discord WeChat
Drillr Discord QR Drillr WeChat group QR
Devs building agentic research products β€” office hours, debugging help, early access. Chinese-speaking dev community β€” fastest product feedback.
## License MIT β€” see [`LICENSE`](./LICENSE).