{
"markdown": "\n\nπ **English** Β· [δΈζ](./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)\n[](https://modelcontextprotocol.io)\n[](./docs/tools.md)\n[](./docs/rest-api.md)\n[](https://drillr.ai/developer/docs)\n[](https://github.com/Little-Grebe-Inc/drillr-mcp-server/issues)\n\n
\n\nBrowser sign-in. No API key to copy. Nine tools for agent research: standardized financial data, company discovery, semantic news and event search, paragraph-cited company filings, and 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. Add `https://gateway.drillr.ai/mcp/data` to an OAuth-capable MCP client\n3. Sign in and approve the named client in your browser. No secret is displayed or copied.\n\n### Claude Code\n\n```bash\nclaude mcp add --scope user --transport http drillr \\\n https://gateway.drillr.ai/mcp/data\nclaude mcp login drillr\n```\n\n### Codex CLI\n\n```bash\ncodex mcp add drillr --url https://gateway.drillr.ai/mcp/data\n```\n\nCodex starts browser sign-in during setup. For an existing entry, run `codex mcp login drillr`.\n\n### Claude Desktop / OAuth-capable hosts\n\n```jsonc\n{\n \"mcpServers\": {\n \"drillr\": {\n \"type\": \"http\",\n \"url\": \"https://gateway.drillr.ai/mcp/data\"\n }\n }\n}\n```\n\nRestart the host after saving, then approve Drillr in the browser when prompted.\n\n### Cursor / VS Code\n\nOne click writes the server entry; your editor then signs you in through the browser.\n\n[](https://cursor.com/en/install-mcp?name=drillr&config=eyJ1cmwiOiJodHRwczovL2dhdGV3YXkuZHJpbGxyLmFpL21jcC9kYXRhIn0=) [](https://insiders.vscode.dev/redirect/mcp/install?name=drillr&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fgateway.drillr.ai%2Fmcp%2Fdata%22%7D)\n\n### API-key fallback\n\nUse this only for REST or an MCP host that does not support browser OAuth. Create an `external` key at [drillr.ai/developer/keys](https://drillr.ai/developer/keys), store it as a secret, and add:\n\n```jsonc\n\"headers\": { \"Authorization\": \"Bearer \" }\n```\n\n#### Hermes Agent fallback\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 uses the same Streamable HTTP endpoint. Omit `headers` and use browser OAuth whenever the host supports it; otherwise use the API-key fallback above. Never configure OAuth and a static bearer header on the same server entry.\n\n### Smithery fallback\n\n```bash\nnpx -y @smithery/cli install drillr/drillr --client claude\n```\n\nSmithery offers the API key as an optional field. Leave it empty on an OAuth-capable client and sign in through the browser instead.\n\nListing: https://smithery.ai/servers/drillr/drillr\n\n### Claude Code plugin fallback\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\nThe plugin installs the server without a key. Restart Claude Code, run `/mcp`, pick `drillr`, and choose `Authenticate`.\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](./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 across company filings in the US, Japan, Hong Kong, and China A-shares |\n| `sec_report_list` | List a ticker's indexed filings by filing type |\n| `company_search` | Four-market qualitative discovery by business model, supply chain, peers, or theme |\n| `news_search` | Semantic search over news, market events, and attributed claims, grouped into storylines |\n| `ticker_lookup` | Resolve a company name, brand, or ticker substring to ticker history |\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`](./docs/tools.md).\n\n## What's Covered\n\n- **Core equity coverage**: US, Japan, Hong Kong, and China A-shares. Ticker formats: `AAPL`, `6758.T`, `00700.HK`, `600519.SH` / `300750.SZ`.\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**: `financial_statements`, `company_snapshot`, and `price_volume_history` cover all four core markets; financial history reaches back to the 1980s\n- **Company filings**: SEC EDGAR, Japan EDINET, HKEX, and China A-share reports with paragraph-level semantic search\n- **Earnings**: call transcripts with AI-structured summaries and estimate-vs-actuals history; this specialized dataset covers US + Japan\n- **Markets**: equities, ETFs, indices, forex, crypto, commodities\n- **Specialized US datasets**: analyst ratings, ownership, executives, 8-K events, and extended-hours quotes\n- **News + events**: continuously updating four-market and cross-asset search with story grouping and attributed claims\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`](./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`](./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 | Discord | \n WeChat | \n
\n \n ![\"Drillr](\"https://gateway.drillr.ai/qr/discord.svg\") | \n ![\"Drillr](\"https://gateway.drillr.ai/qr/wechat.svg\") | \n
\n \n | Devs building agentic research products β office hours, debugging help, early access. | \n Chinese-speaking dev community β fastest product feedback. | \n
\n
\n\n## License\n\nMIT β see [`LICENSE`](./LICENSE).\n",
"bytes": 9593,
"sha": "d64640e5fde83b90bd1cb49472d413a522a446e612570c27368da5bb880c1327",
"repo_slug": "little-grebe-inc/drillr-mcp-server",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_ai_drillr_drillr_b581a434/readme"
}