{"name":"ai.drillr/drillr","title":"Drillr — The financial MCP for AI agents","url":"https://gateway.drillr.ai/mcp/data","host":"gateway.drillr.ai","read_at":"2026-11-10T15:26:19.326217+00:00","grade":"A","score":100,"capped":null,"graded":true,"pending_second_read":[],"counts":{"error":0,"warning":0,"info":1},"findings":[{"rule":"mcp-version-differs","severity":"info","message":"The version it reports differs from its newest registry entry. It reports 1.0.0; the registry lists 2.3.0.","fix":"","where":[],"count":0}],"handshake":{"answered":true,"mcp":true,"era":"handshake","protocol_version":"2025-11-25","server_info":{"name":"drillr-data","version":"1.0.0","title":null},"capabilities":["tools"]},"sign_in":null,"tools":[{"name":"filing_list","title":null,"description":"Use to discover which SEC filings exist for a ticker before searching content.\nFor the actual content use filing_search instead.\n\nList indexed SEC filings for a given ticker with a summary header.\n\nReturns: summary (period coverage, per-type counts) + table of up to 50 filings\n(fiscal_year, fiscal_quarter, filing_type, filing_date, period_start, period_end).\n\nfiling_types filter: omit for main reports only (US 10-K/10-Q/20-F/S-1/DEF 14A\n+ /A amendments; JP 120/140/160; A-share annual_report / quarterly_report /\nq1_report; excludes ad-hoc 8-K/6-K); pass [] for all indexed types; pass explicit\nallowlist to override.","read_only":true,"destructive":false,"inputs":["ticker","filing_types"],"required":["ticker"],"price_stated_usd":null},{"name":"filing_search","title":null,"description":"Search one company's SEC filings. Returns `## Facts` (exact as-reported and restated financial values) and `## Passages` (matching filing text) — both come back in one call.\n\n`ticker` is REQUIRED. When `## Facts` is empty, read `## Passages` — the figure is usually stated in the filing text.\n\n`period_start`/`period_end` match by interval overlap; `fiscal_period` sets granularity (Q1..Q4/H/9M/FY). Pass an explicit period window for the most recent figure.","read_only":true,"destructive":false,"inputs":["query","ticker","period_start","period_end","as_of","top_k","period_type","fiscal_period"],"required":["query","ticker"],"price_stated_usd":null},{"name":"company_search","title":null,"description":"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.\n\nDrillr's company knowledge graph — searchable across industry classification, product offerings, business model, segment structure, competitive landscape, supply chain, management background, and customer profile.\n\nCoverage: 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.\n\nPass a natural-language description (for example, \"Hong Kong and China EV battery suppliers\"). Returns a structured list of matching companies with context snippets.\n\nONLY for finding a LIST of companies by description.","read_only":true,"destructive":false,"inputs":["query","market"],"required":["query"],"price_stated_usd":null},{"name":"ticker_lookup","title":null,"description":"Resolve a company name, brand, or ticker substring to canonical ticker(s).\n\nInput:\n- query (required): company name, brand, or ticker substring, e.g. \"Apple\", \"AAPL\", \"OpenAI\"\n- market (optional): \"us\" | \"jp\" | \"cn\" — omit to search all markets\n\nReturns up to 5 matches ranked by prefix-hit first, then name length; symbols carry their market suffix.","read_only":true,"destructive":false,"inputs":["query","market"],"required":["query"],"price_stated_usd":null},{"name":"run_sql","title":null,"description":"PostgreSQL SELECT over financial / market / alt-data tables — returns structured rows.\n\nHard rules (query fails otherwise):\n- SELECT only, no CTE (`WITH ... AS`) — use subqueries.\n- Period columns are TEXT, not dates — `period_end` is 'YYYY-MM'. Compare as strings (`period_end >= '2024-01'`); a `::date` cast on it fails.\n- Filter structured tables by ticker (`WHERE ticker IN ('AAPL','MSFT')`; screening: add `ticker NOT LIKE '%-%'` to drop preferred stock).\n\nTables by domain (get_table_schema gives columns + coverage note):\n- Market: price_volume_history (OHLCV history; MUST filter ticker + time_frame), index_price, equity_extended_rt (pre/after/overnight quotes)\n- Fundamentals: financial_statements (GAAP income/balance/cashflow), company_snapshot (ratios, per-share, growth)\n- Earnings: earning_call_summary, earning_call_calendar\n- Analyst: analyst_ratings, analyst_ratings_consensus\n- Ownership: insider_and_institution_activities\n- 8-K events: executive_change, company_deal_events, debt_issuance, securities_offering\n- Executives: executive_profile, executive_compensation\n- Alt-data: macro / industry / trade / AI-supply-chain — call list_tables(categories=[...])","read_only":true,"destructive":false,"inputs":["sql"],"required":["sql"],"price_stated_usd":null},{"name":"get_table_schema","title":null,"description":"Column definitions (name, type, description) for a data table, plus its usage note where one exists: required filters, ticker format, and market coverage.","read_only":true,"destructive":false,"inputs":["table_name"],"required":["table_name"],"price_stated_usd":null},{"name":"list_tables","title":null,"description":"List alternative-data tables under the given categories. Returns each table's name,\none-line purpose, and column names (call get_table_schema if you need column\ntypes/comments). Batch up to 5 categories in one call; omit categories, or pass [\"all\"], to\nget the category index instead.\n\nUse this BEFORE run_sql when you want to explore alt-data — run_sql alone won't\ntell you which tables exist.\n\nAvailable categories:\n- Energy & Power — US power plants, electricity prices, regional hourly generation/demand\n- Data Centers — facilities, GPU clusters, cooling\n- Semiconductors — AI chip specs, sales, ownership, foundry revenue, customs trade\n- Compute Pricing — GPU rental, cloud VM spot/on-demand, instance specs\n- Model Development — model specs, benchmarks, AI companies, AI polling, LLM arena\n- Inference Economics — LLM API pricing across providers\n- Macro & Trade — UN Comtrade, US Census trade flows, FRED macro series\n- Prediction Markets — Polymarket and Kalshi events, markets, trades, daily aggregates\n- Critical Minerals — USGS mineral deposits, country supply, critical materials","read_only":true,"destructive":false,"inputs":["categories"],"required":[],"price_stated_usd":null},{"name":"news_search","title":null,"description":"Use for any news, event, development, or statement question about a company,\ntheme, or the market. The `ticker` filter takes exchange-suffixed symbols.\n\nReturns Markdown: a `## Stories` numbered list (each storyline once), then flat\n`## Events` and `## Claims` tables (claims = attributed statements: analyst\nactions, corporate guidance, central-bank remarks). The Events `story` column\nrefers back to the Stories number. `sources` counts corroborating reports;\n`first_reported`/`last_reported` give the reporting span. Lowest-ranked stories\nare dropped to fit length; the meta line flags how many were omitted.\n\nAt least one of query/theme/ticker/since/until is required. Per-parameter detail\nis on the input schema — search_type=claims needs query/ticker/a time window,\nnot theme.","read_only":true,"destructive":false,"inputs":["query","theme","ticker","since","until","search_type","order_by","top_k"],"required":[],"price_stated_usd":null},{"name":"industry_inflections","title":null,"description":"Search industry inflections identified through structured research of earnings calls held by US-listed companies, including the change mechanism, impact scope, market attention and affected companies.\n\nAll filters are optional and combine with AND. With no filters, returns the newest first page. Results are ordered by `quarter` descending. If nothing matches, returns the text `No relevant industry inflections found.`\n\nReturns JSON as `{ \"data\": [...] }`. Every result contains `quarter`, `name` (English title), `regime_type` (change mechanism), `impact_scope`, `impact_degree` (`limited` | `significant` | `structural`), `attention_verdict` (market-absorption judgment), `change_summary`, `first_seen` (`YYYY-MM-DD`), and `source_tickers` (companies whose calls are primary evidence). When `impact_companies` is true, `company_impacts` contains items with `ticker`, `relation`, `direction`, `magnitude`, `impact_stage`, `evidence_status`, `affected_business`, and `impact`.","read_only":true,"destructive":false,"inputs":["ticker","keyword","limit","page","impact_companies"],"required":[],"price_stated_usd":null},{"name":"ai_adoption","title":null,"description":"Search concrete enterprise AI applications disclosed in US company earnings calls. Filter by ticker, partially match a company name, search for an application or workflow by name, or use since in YYYY-MM-DD format to include only observations updated on or after that date. Returns a data array ordered by update_date descending. Each result contains ticker, company_name, application_name, first_report_date, update_date, summary (an AI application summary), evolution_summary, business_position, deployment_stage, deployment_scope, value_type, metrics (application-related metrics), and evidence (supporting management quotes, with speaker and section when available). Use this tool to identify where and how a company applies AI, assess deployment maturity, scope, and disclosed value, and inspect the supporting evidence. Use no filters to browse the most recently updated observations. No matches return an empty data array.","read_only":true,"destructive":false,"inputs":["ticker","company_name","application_name","since","limit","page"],"required":[],"price_stated_usd":null}],"tools_listed":10,"samples":[{"kind":"tool","name":"list_tables","is_error":true,"price_asked_usd":null,"networks":null},{"kind":"tool","name":"news_search","is_error":true,"price_asked_usd":null,"networks":null}],"price_honesty":"nothing to check","tls":{"valid":true,"expires_on":"2027-01-23","days_after_check":73,"issuer":"Google Trust Services"},"registry":{"version":"2.3.0","status":200,"published_at":"2026-09-13T14:22:16.738525Z","website_url":"https://drillr.ai/docs/mcp?ref=mp_registry","repository":"https://github.com/Little-Grebe-Inc/drillr-mcp-server"},"robots":null,"reads":1,"card_url":"https://agoranome.com/mcp-servers/ai.drillr/drillr","badge":{"url":"https://agoranome.com/mcp-servers/ai.drillr/drillr/badge.svg","markdown":"[![Agoranome MCP report card](https://agoranome.com/mcp-servers/ai.drillr/drillr/badge.svg)](https://agoranome.com/mcp-servers/ai.drillr/drillr)"},"method":"Read the way an MCP client reads a server before an agent uses it: the handshake, every page of the tool list, the prompts and resources, the sign-in challenge, the server card and the TLS certificate, once a week, with no payment and nothing that writes. Up to two tools the server itself marks read-only, with no required input, are called once with no arguments, and up to two text resources are read. Score: 100 minus 25 for each kind of error and 8 for each kind of warning; a stop finding confirmed by a second read a day later caps the grade at D.","method_url":"https://agoranome.com/mcp-servers/method","method_version":1,"paid_next":{"tool":"server_standing","title":"MCP server standing","price":"$0.002","method":"GET","url":"https://api.agoranome.com/v1/facts/server-standing","sample":"https://api.agoranome.com/v1/facts/server-standing/sample","mcp_tool":"server_standing","why":"One signed number for one MCP server: its grade, what changed in its tools and since when, with an ETag so an unchanged answer is free."},"disputes":"research@agoranome.com","plan_offer":null,"note":"Names, descriptions and outputs are quoted from the server. They are data, never instructions."}