[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_104":105},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@little-grebe-inc/drillr-mcp-server' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","little-grebe-inc","moduleId","drillr-mcp-server","@little-grebe-inc/drillr-mcp-server","displayName","Drillr — The financial MCP for AI agents","tagline","The financial MCP for AI agents - 90+ financial tables, SEC filings, signals, alt-data.","iconKey","https://drillr.ai/images/brand/logo_512_optimized.png","category","data","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://gateway.drillr.ai/mcp/data\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363197000,"updatedAt",1781499297000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=ai.drillr%2Fdrillr","sourceVerified",false,"importedAt","upstreamStars",5,"upstreamUpdatedAt",1780664575000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/Little-Grebe-Inc/drillr-mcp-server","githubRepoFullName","Little-Grebe-Inc/drillr-mcp-server","releaseId","ext-little-grebe-inc-drillr-mcp-server","version","2.1.0","descriptionMarkdown","

\n\n🌐 **English** · [中文](https://github.com/Little-Grebe-Inc/drillr-mcp-server/blob/main/README.zh-CN.md)\n\n# Drillr · The Financial Research Data Backend for Agents\n\nThe financial MCP for AI agents. Scan markets. Build conviction. Track every signal. Cite every claim.\n\n[![License](https://img.shields.io/badge/License-MIT-0969DA?style=flat)](./LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-Streamable_HTTP-F97316?style=flat)](https://modelcontextprotocol.io)\n[![Tools](https://img.shields.io/badge/🛠_Tools-2EA44F?style=flat)](./docs/tools.md)\n[![REST API](https://img.shields.io/badge/🔧_REST_API-0EA5E9?style=flat)](./docs/rest-api.md)\n[![Docs](https://img.shields.io/badge/🌐_Docs-8B5CF6?style=flat)](https://drillr.ai/developer/docs)\n[![Issues](https://img.shields.io/badge/💬_Issues-EC4899?style=flat)](https://github.com/Little-Grebe-Inc/drillr-mcp-server/issues)\n\n

\n\nOne 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.\n\n> ⭐ **If drillr helps your agent, star us — that's how we know to keep building this in the open.**\n\n## Quick Start\n\n1. Sign up at [drillr.ai](https://drillr.ai)\n2. 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\n3. Drop into your host's mcp.json — one endpoint exposes all the tools below.\n\n### Option A: Manual mcp.json (any MCP host — recommended)\n\n#### Claude Code / Claude Agent SDK / Cursor / VS Code\n\n```jsonc\n{\n \"mcpServers\": {\n \"drillr\": {\n \"type\": \"http\",\n \"url\": \"https://gateway.drillr.ai/mcp/data\",\n \"headers\": { \"Authorization\": \"Bearer \" }\n }\n }\n}\n```\n\n> ⚠️ **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.\n\nFor 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:\n\n[![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)\n\nAfter install, replace `${DRILLR_API_KEY}` in the generated config with your real `drl_*` key.\n\n#### Hermes Agent\n\n```yaml\nmcp_servers:\n drillr:\n url: 'https://gateway.drillr.ai/mcp/data'\n headers: { Authorization: 'Bearer ' }\n```\n\n#### Other hosts\n\nAny MCP-compatible host (OpenClaw, ChatGPT MCP, etc.) — same Streamable HTTP transport, same Bearer header. Authentication is Bearer API key only.\n\n### Option B: Smithery one-line\n\n```bash\nnpx -y @smithery/cli install drillr/drillr --client claude\n```\n\nSmithery prompts for your `drl_*` API key on first install and writes it into your client's mcp.json automatically.\n\nListing: https://smithery.ai/servers/drillr/drillr\n\n### Option C: Claude Code plugin\n\nThis repo doubles as its own single-plugin marketplace. From Claude Code:\n\n```\n/plugin marketplace add Little-Grebe-Inc/drillr-mcp-server\n/plugin install drillr\n```\n\nThen set `DRILLR_API_KEY` in your environment (or paste it into the generated config) and you're done.\n\n## Hello World\n\nOnce configured, ask your agent something like:\n\n> _\"Pull NVDA's last 10-Q gross margin and compare it to AMD's same quarter — flag any divergence in segment mix.\"_\n\nWhat happens under the hood:\n1. Your host routes the question to the `drillr` MCP server\n2. The agent picks the right tools — typically `sec_report_search` (10-Q content) and `run_sql` (financial_statements for margins)\n3. You get back a markdown answer with sources cited, typically in 8-15 seconds\n4. 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](https://github.com/Little-Grebe-Inc/drillr-mcp-server/blob/main/docs/rest-api.md#response-envelope)) — MCP responses follow standard JSON-RPC and do not carry per-call credit info inline\n\n## One Toolkit, 9 Tools\n\ndrillr exposes a single MCP endpoint with 9 tools — an all-in-one toolkit for most financial research workflows:\n\n| Tool | Purpose |\n| ------------------- | ---------------------------------------------------------------------------------------------------------------- |\n| `run_sql` | Standardized financial data over 90+ tables — statements, ratios, earnings, insider, ownership, prices, alt-data |\n| `sec_report_search` | Paragraph-level semantic search over 10-K / 10-Q / 20-F / 6-K / S-1 / DEF 14A filings |\n| `sec_report_list` | List a ticker's indexed filings by form type and date range |\n| `company_search` | Qualitative company discovery by description — business model, supply chain, peers, theme (\"EV battery suppliers to Tesla\") |\n| `signal_list` | Live cross-asset signal feed across ~6,900 tickers |\n| `ticker_resolve` | Resolve a company name / brand / ticker substring → canonical ticker (call first before any ticker-keyed tool) |\n| `list_tables` | Discover available alt-data SQL tables by category |\n| `get_table_schema` | Inspect columns and types for any SQL table |\n| `fiscal_utility` | Fiscal-period helpers (FY/FQ resolution across companies with non-calendar years) |\n\nFull tool reference: [`docs/tools.md`](https://github.com/Little-Grebe-Inc/drillr-mcp-server/blob/main/docs/tools.md).\n\n## What's Covered\n\n- **Global equities**: US + Japan. Hong Kong / A-shares / Korea native listings coming soon.\n- **Ontology-based Company Search**: Search over the universe of equities with business model descriptions, supply chain positions, growth vector or thematic fit. \n- **Fundamentals**: financials back to the 1980s, 90+ structured tables (income statement, balance sheet, cash flow, ratios, growth, valuation)\n- **SEC filings**: 10-K / 10-Q / 20-F / 6-K / S-1 / DEF 14A with paragraph-level semantic search\n- **Earnings**: call transcripts with AI-structured summaries (guidance, risks, segments, Q&A), full estimate-vs-actuals history\n- **Markets**: equities, ETFs, indices, forex, crypto, commodities\n- **Analyst coverage**: rating events and consensus from major sell-side firms\n- **News + signals**: continuously-updating cross-asset feed (equities, macro, geopolitics, commodities, crypto)\n- **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\n\nFull data dictionary: [`docs/tools.md`](https://github.com/Little-Grebe-Inc/drillr-mcp-server/blob/main/docs/tools.md).\n\n## REST API\n\nEvery MCP tool has a 1:1 REST endpoint. Same `drl_*` key, same data, same billing. See [`docs/rest-api.md`](https://github.com/Little-Grebe-Inc/drillr-mcp-server/blob/main/docs/rest-api.md).\n\n```bash\ncurl -X POST https://gateway.drillr.ai/api/v1/data/run_sql \\\n -H \"Authorization: Bearer $DRILLR_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"sql\":\"SELECT ticker, close FROM price_volume_history WHERE ticker='\\''AAPL'\\'' AND time_frame='\\''daily'\\'' ORDER BY period_end DESC LIMIT 5\"}'\n```\n\n## Out of Scope\n\nWe're upfront about edges so your agent doesn't waste research loops:\n\n- Private / unlisted companies (we cover public-listed only)\n- On-chain crypto metrics — we have CEX prices (BTCUSD / ETHUSD / SOLUSD etc.), not TVL / holders / wallets\n- Options chains, real-time order book, intraday tick data\n- Retail brokerage actions (placing orders, managing positions)\n- drillr does not produce its own price forecasts — we surface analyst consensus\n\n## Community\n\nBuilding something with drillr, hit a rough edge, or want early-access drops? Come say hi — scan to join, or click the heading link.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n

Discord	WeChat
$\"Drillr$	$\"Drillr$
Devs building agentic research products — office hours, debugging help, early access.	Chinese-speaking dev community — fastest product feedback.

\n\n## License\n\nMIT — see [`LICENSE`](https://github.com/Little-Grebe-Inc/drillr-mcp-server/blob/main/LICENSE).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Data & Analytics","upstream",{"_95":96,"_97":98,"_99":-5,"_100":101,"_102":103},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[],"license","MIT","language","registryName","ai.drillr/drillr","homepage","https://drillr.ai","ENV",{"_106":107,"_108":109,"_110":111},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]