Drillr — The financial MCP for AI agents
@Little-Grebe-Inc
Basic information
About Drillr — The financial MCP for AI agents
Drillr — the financial MCP for AI agents. Standardized financial data, SEC filings semantic search, live signals, and 24 alt-data categories.
Drillr — The financial MCP for AI agents config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"drillr-data": {
"type": "http",
"url": "https://gateway.drillr.ai/mcp/data"
}
}
}Drillr — The financial MCP for AI agents tools
9Use to discover which SEC filings exist for a ticker before searching content. For the actual content use sec_report_search instead. List indexed SEC filings for a given ticker with a summary header. Returns: summary (period coverage, per-type counts) + table of up to 50 filings (fiscal_year, fiscal_quarter, filing_type, filing_date, period_start, period_end). filing_types filter: omit for main reports only (US 10-K/10-Q/20-F/S-1/DEF 14A + /A amendments; JP 120/140/160; HK/A-share annual_report / quarterly_report / q1_report; KR A001/A002/A003 + C001/C005; excludes ad-hoc 8-K/6-K); pass [] for all indexed types; pass explicit allowlist to override.
Use when you need narrative content from company filings — risk factors, MD&A, guidance language, deal terms, accounting policies, share structure. For consolidated financial numbers use run_sql on financial_statements instead. Semantic search over the full text of company-filed reports; returns matching passages. Coverage: US + Japan + Hong Kong + China A-shares + Korea. US = SEC EDGAR (including foreign issuers' 20-F/6-K). Japan = EDINET, `.T` ticker (6758.T). Hong Kong = HKEX filings, 5-digit `.HK` ticker (00700.HK). A-shares = `.SH`/`.SZ` (600519.SH). Korea = DART filings, `.KS`/`.KQ` (005930.KS); filings are Korean — query in Korean. Parameters: - query (required): natural-language search; phrase it as the concept or section name you want, e.g. "share repurchase authorization", "Risk Factors". Run a few phrasings rather than one broad query. - ticker (required): US bare (NVDA), Japan `.T`, HK `.HK`, A-share `.SH`/`.SZ`, Korea `.KS`/`.KQ`, ADRs as their US symbol (SONY). - filing_types (optional): US = SEC form names (10-K, 10-Q, 8-K, 20-F, 6-K, DEF 14A, S-1/F-1, + amendments). Japan = EDINET NUMERIC codes: 120 (annual), 140 (quarterly), 160 (semi-annual). HK/A-share = plain names — annual_report; A-share quarters per-quarter (q1_report, ...); HK quarterly results all quarterly_report. Korea = DART codes: A001 (annual), A002 (semi-annual), A003 (quarterly), C001/C005 (registration/prospectus). OMIT to search all types. - period_start / period_end (optional): yyyy-mm window; omit to search all history. - top_k (optional): max passages to return (default 10). Scope: indexes ONLY company-filed reports — NOT institutional filings (13F-HR/13D/13G; for those use insider_and_institution_activities with source='institution'). Section targets: non-GAAP reconciliations → earnings 8-K (Ex 99.1); dilution / SBC / buyback → "Shareholders' Equity"; segment breakdown → "Segment Information"; guidance → "Outlook" in MD&A; exec comp → DEF 14A.
Use for qualitative company discovery (industry, business model, supply chain, competitors, management background). For numerical screening (revenue, margins, ratios, growth rates) use run_sql on company_snapshot instead. Drillr's company knowledge base — searchable across industry classification, product offerings, business model, segment structure, competitive landscape, supply chain, management background, and customer profile. Coverage: US, Japan, Hong Kong, China A-shares, and Korea. `market` accepts one lowercase value or a list from `us | jp | hk | cn | kr`; omit it or pass `[]` for all five. List order does not set priority. Pass a natural-language description (for example, "Hong Kong and China EV battery suppliers"). Returns a structured list of matching companies with context snippets. ONLY for finding a LIST of companies by description.
Resolve a company name, brand, or ticker substring to canonical ticker(s). Use this FIRST when the user mentions a company by name/brand/nickname before running any ticker-keyed tool. Input: - query (required): company name, brand, or ticker substring, e.g. "Apple", "苹果", "AAPL", "OpenAI" - market (optional): "us" | "jp" | "hk" | "cn" | "kr" — omit to search all markets Returns up to 5 matches ranked by prefix-hit first, then name length. Returned symbols carry their market suffix: US bare (AAPL), Japan `.T`, Hong Kong 5-digit `.HK` (00700.HK), A-share `.SH`/`.SZ` (600519.SH), Korea `.KS`/`.KQ` (005930.KS).
PostgreSQL SELECT over financial / market / alt-data tables — returns structured rows. Hard rules (query fails otherwise): - SELECT only, no CTE (`WITH ... AS`) — use subqueries. - Period columns are TEXT, not dates — `period_end` is 'YYYY-MM'. Compare as strings (`period_end >= '2024-01'`); a `::date` cast on it fails. - Filter structured tables by ticker (`WHERE ticker IN ('AAPL','MSFT')`; screening: add `ticker NOT LIKE '%-%'` to drop preferred stock). Core equity coverage: US, Japan, Hong Kong, China A-shares, and Korea. Tickers are US bare (AAPL), Japan `.T` (6758.T), Hong Kong `.HK` (00700.HK), A-shares `.SH`/`.SZ` (600519.SH), and Korea `.KS`/`.KQ` (005930.KS). financial_statements, company_snapshot, and price_volume_history span all five. Specialized tables may be narrower — call get_table_schema before treating an empty result as a finding. Tables by domain (call get_table_schema for detail): - Market: price_volume_history (OHLCV history; MUST filter ticker + time_frame), index_price, equity_extended_rt (pre/after/overnight quotes) - Fundamentals: financial_statements (GAAP income/balance/cashflow), company_snapshot (ratios, per-share, growth) - Earnings: earning_call_summary, earning_call_calendar - Analyst: analyst_ratings, analyst_ratings_consensus - Ownership: insider_and_institution_activities - 8-K events: executive_change, company_deal_events, debt_issuance, securities_offering - Executives: executive_profile, executive_compensation - Alt-data: macro / industry / trade / AI-supply-chain — call list_tables(categories=[...])
Use BEFORE run_sql when you're unsure which columns a table has. Look up column definitions (name, type, description) for a data table.
Use to convert between fiscal year/quarter and calendar months for a ticker before filtering period_end columns. Coverage warning: fiscal-year configuration is primarily US, with sparse JP/HK entries and no China A-share coverage in the verified dataset. Do not assume this tool supports a ticker merely because the core equity tables do. Forward: ticker + fiscal_year + fiscal_quarter → period_start/period_end. Reverse: ticker + yyyy_mm → fiscal_year/fiscal_quarter.
List alternative-data tables under the given categories. Returns each table's name, one-line purpose, and column names (call get_table_schema if you need column types/comments). Batch up to 5 categories in one call; omit categories, or pass ["all"], to get the category index instead. Use this BEFORE run_sql when you want to explore alt-data — run_sql alone won't tell you which tables exist. Available categories: - Energy & Power — US power plants, electricity prices, regional hourly generation/demand - Data Centers — facilities, GPU clusters, cooling - Semiconductors — AI chip specs, sales, ownership, foundry revenue, customs trade - Compute Pricing — GPU rental, cloud VM spot/on-demand, instance specs - Model Development — model specs, benchmarks, AI companies, AI polling, LLM arena - Inference Economics — LLM API pricing across providers - Macro & Trade — UN Comtrade, US Census trade flows, FRED macro series - Prediction Markets — Polymarket and Kalshi events, markets, trades, daily aggregates - Critical Minerals — USGS mineral deposits, country supply, critical materials
Use for any news, event, development, or statement question about a company, theme, or the market. Covers US, Japan, Hong Kong and A-share markets; The `ticker` filter takes exchange-suffixed symbols: US bare (AAPL), Japan `.T` (7203.T), Hong Kong `.HK` (00700.HK), A-share `.SH`/`.SZ` (600519.SH). Returns Markdown: a `## Stories` numbered list (each storyline once), then flat `## Events` and `## Claims` tables (claims = attributed statements: analyst actions, corporate guidance, central-bank remarks). The Events `story` column refers back to the Stories number. `sources` counts corroborating reports; `first_reported`/`last_reported` give the reporting span. Lowest-ranked stories are dropped to fit length; the meta line flags how many were omitted. At least one of query/theme/ticker/since/until is required. Per-parameter detail is on the input schema — search_type=claims needs query/ticker/a time window, not theme.
Overview
What is drillr
drillr is a financial data and research API for the US, China and Japan, exposed to AI agents as an MCP server. Filings are taken from each market's official channel (SEC EDGAR, cninfo, EDINET) and parsed in house; every reported figure links back to the passage it was filed in. Docs: https://drillr.ai/docs/mcp
Ten tools
- Company —
ticker_lookup(name / brand / substring → canonical symbols, historical names included),company_search(natural-language description → companies with a match reason; US / CN / JP / HK / KR) - Filings —
filing_list(which filings are indexed for a ticker),filing_search(search one company's filings; returns structured as-reported facts and the filed text together) - Datasets —
list_tables,get_table_schema,run_sql(one read-only PostgreSQL SELECT over statements, prices, earnings, ownership, analyst, event and executive tables) - Signal —
industry_inflections(industry changes synthesized from many US earnings calls),ai_adoption(concrete enterprise AI applications disclosed on US earnings calls),news_search(storylines, events and attributed claims across sources)
Each tool has a page at https://drillr.ai/docs/mcp/ with parameters, limits and error shapes.
What the data is
Filings with full-text and fact search (US / CN / JP) · income statement, balance sheet, cash flow as reported plus valuation metrics (US / JP / HK / CN / KR) · prices, indices, extended-hours quotes · earnings calendar and structured call summaries (US / JP) · insider trades and 13F holdings (US) · 8-K corporate events and 13D/G stakes (US) · executive rosters and compensation (US) · analyst ratings and consensus (US) · research signals with evidence · a secondary set of macro and AI-supply-chain tables reachable through list_tables.
Setup
Server drillr-data, URL https://gateway.drillr.ai/mcp/data, Streamable HTTP, browser OAuth. No API key: the client opens drillr in the browser and you click Allow. Per-client steps: https://drillr.ai/developer/mcp-install.md. Hosts without OAuth can pass "headers": {"Authorization": "Bearer drl_…"} with a key from https://drillr.ai/account/api-keys.
Pricing
One credit wallet across MCP and REST. 80 free credits on sign-up; ticker, schema and table tools are free; run_sql and filing tools 0.1 cr per call; news_search 0.2 cr; signal tools 1 cr; company_search 3–5 cr. https://drillr.ai/pricing
Out of scope
Private companies, on-chain metrics, options chains, order books, tick data, order placement. drillr does not produce its own price forecasts.
REST API
The same data as 29 typed REST endpoints: https://drillr.ai/docs/api · OpenAPI: https://gateway.drillr.ai/api/v2/openapi.json
More Finance & Commerce MCP servers
Capital.com MCP
capital-com-svCFDs are complex instruments and come with a high risk of losing money rapidly due to leverage. 81.31% of retail investor accounts lose money when trading CFDs with this provider. You should consider whether you understa
DeFade
DeFade LtdMemecoin rug pull forensics for AI assistants. Scan any token on Solana, Ethereum, Base, BSC, Robinhood, Arc or Hyperliquid for launch bundles, snipers, insider networks, funding origins, dev wallets and a 0-100 rug scor
Senaro Personal Finance
SenaroCredit card payoff, mortgages, refinancing, 401(k), rent vs buy. Every rule and default is cited. No sign-up, no API key. Calculation only, not financial advice.
Tradetron
TradetronBuild, backtest and diagnose algo trading strategies in your own Tradetron account in plain English. Remote server with OAuth sign-in; it never places a live order.
Priors
priors-agentsOn-chain credit pool for ERC-8004 AI agents on Robinhood Chain: agents borrow USDG, repay it and earn a public credit score. Contracts, SDK, CLI, MCP server (@priors/mcp), x402 helpers (@priors/x402) and an agent skill.
Comments