ask_company_research
Ask questions across a company's annual reports and earnings-call transcripts to retrieve relevant excerpts with document and page citations; narrow by document type, year, quarter, or PDF.
Instructions
Ask a question over a company's annual reports and earnings-call transcripts using semantic search — across all recent documents at once, one document type, or a single document.
ask_company_research("TCS", "How has capex strategy evolved?") # 3 ARs + 4 calls ask_company_research("ITC", "Key regulatory risks", doc_type="annual_report") ask_company_research("TCS", "Key risks", year=2024) # one annual report ask_company_research("HDFCBANK", "NIM guidance", quarter="Q3FY25") # one earnings call
Downloads and indexes the PDFs locally on first use (cached after that), then returns the most relevant excerpts (each capped to ~900 characters, with document and page) — BRSR/sustainability boilerplate is ranked down unless the question is about ESG.
doc_type: "all" | "annual_report" | "earnings_call" year: one annual report (e.g. 2024) — implies doc_type="annual_report" quarter: one earnings call (e.g. "Q1FY26") — implies doc_type="earnings_call" pdf_url: search this PDF directly (label it with year or quarter) max_annual_reports / max_earnings_calls: how many recent documents to include when no year/quarter is given force_reindex: re-download and rebuild the index (see each document's freshness.source_changed)
Requires the [ai] extra: pip install 'screener-mcp[ai]'
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"symbol": "<symbol>"
},
"name": "ask_company_research"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | ||
| symbol | Yes | ||
| pdf_url | No | ||
| quarter | No | ||
| doc_type | No | all | |
| question | No | ||
| force_reindex | No | ||
| max_annual_reports | No | ||
| max_earnings_calls | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||