Drillr — The financial MCP for AI agents

What Drillr — The financial MCP for AI agents does

Drillr — The financial MCP for AI agents provides a hosted MCP endpoint for researching public companies and markets. Its coverage includes company resolution and discovery, regulatory filings, financial statements, prices, earnings information, ownership activity, corporate events, and research signals. The documented market coverage spans US, China, and Japan for several core datasets, with additional financial, price, discovery, and ownership coverage described for Japan, Hong Kong, and South Korea.

The service emphasizes provenance for reported figures. Filing search can return both structured as-reported facts and the passages where those facts appear, including details such as the reporting period, XBRL concept, and accession number. Agents can also query financial, market, and alternative-data tables with read-only SQL.

How it works

The server is exposed at https://gateway.drillr.ai/mcp/data using Streamable HTTP. An MCP client connects to that URL, authenticates in a browser through OAuth, and loads the tools when the client starts. Clients that do not support browser authentication can send an external API key as a bearer header instead; OAuth and a static header should not be configured together for the same server entry.

The tools are intended to be composed. An agent can resolve a company name with ticker_lookup, discover companies from a natural-language description with company_search, inspect available filings, and search filing text and facts. For tabular work, it can inspect table availability and schemas before issuing one read-only PostgreSQL SELECT through run_sql. Signal tools cover industry changes, disclosed enterprise AI use cases, and semantic news search.

Setup and configuration

Create an account at drillr.ai to receive free credits, then add the hosted URL to an OAuth-capable MCP client under a server name such as drillr-data. Approve the drillr Data application in the browser and restart the client if required. Claude Code and Codex provide command-line setup commands; Cursor, VS Code, and Claude Desktop accept an HTTP server configuration using the same endpoint.

For a host without browser OAuth, create an external key in the drillr account, store it as a secret, and provide Authorization: Bearer <YOUR_DRILLR_API_KEY> in the MCP request headers. The repository also documents a REST API and a companion agent skill, but the MCP connection itself uses the hosted endpoint rather than a local process.

Tools and capabilities

Drillr — The financial MCP for AI agents exposes ten documented tools:

• ticker_lookup resolves names, brands, ticker fragments, and historical names to symbols.
• company_search finds companies from descriptions across supported markets.
• filing_list shows indexed filing types, periods, and dates.
• filing_search searches a company’s filing text and returns related reported facts.
• list_tables and get_table_schema help agents select and understand datasets.
• run_sql executes a single read-only query over financial, market, and alternative-data tables.
• industry_inflections summarizes changes identified across US earnings calls.
• ai_adoption returns disclosed enterprise AI applications and supporting evidence.
• news_search searches company and market news semantically.

Financial datasets include annual and quarterly statements, valuation and operating metrics, price histories, indices, extended-hours quotes, earnings calendars and summaries, and US ownership records. Dataset coverage and query requirements should be checked through the table schema tool and the linked documentation.

Limitations and notes

The endpoint is hosted rather than presented as a local stdio server in the supplied setup instructions. OAuth-capable clients are the primary path, while API-key authentication is a fallback for clients without browser login. Usage consumes credits for several operations, with costs varying by tool; company lookup and table metadata are free, while searches, SQL, and signal calls have documented charges. The service is intended for research and data retrieval, so agents should preserve the filing or passage references when presenting reported figures.