M&A Screen (by industry / deal value / status) [beta]
mars_mergers_screenCross-company M&A screener with filters: date range, industry, minimum deal value, status ('announced'/'completed'/'terminated'/'regulatory_review'). Returns acquirer + target (name, company_id, ticker), announcement_date, deal_value_usd, status, industry, merger_type, strategic_goals, source article URL + snippet, published_at. Source: Mars-resolved mergers from wire services.
v2 (mars-v2 methodology, 2026-06-17): substrate swapped to UUID-keyed company_id. acquirer/target UUIDs surface when known (chain-able). Multi-wire duplicate rows collapse on demand via dedupe=true (keyed on (acquirer_company_id, target_company_id, announcement_date) — UUID-based so trivial name variants collapse correctly).
IMPORTANT: industry is grok3-extracted free-text and drift-prone — for thematic slices use mars_search_articles. deal_value_usd is NULL for undisclosed deals (~40% of small M&A). Status values per v2: 'announced' / 'completed' / 'terminated' / 'regulatory_review' (lowercase). Mars covers both private and public-company M&A. Each deal row carries accession + filing_url (the merger agreement's filing, when one is linked; open with get_filing) and accessions (every SEC filing linked to the deal, max 10); both are empty for news-only deals.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "mars_mergers_screen"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max mergers (default 200, max 1000). | |
| dedupe | No | Legacy no-op — merger_deals_v2 is already deal-grain (one row per deal). Kept for back-compat. | |
| status | No | Deal status: 'announced' | 'completed' | 'terminated' | 'regulatory_review' (lowercase). | |
| date_to | No | ISO date upper bound (default open-ended). | 9999-12-31 |
| industry | No | Exact-match industry (free-text, drift-prone — prefer mars_search_articles for thematic). | |
| date_from | No | ISO date lower bound on announcement_date (default '2023-01-01'). | 2023-01-01 |
| min_value | No | Minimum deal_value_usd (USD). | |
| include_warns | No | Include integrity_tier 'reported' (single secondary news report) and 'warn' rows (known extraction bugs — trillion-dollar misparses, self-mergers, sentinel names). Default false (only verified+vouched). | |
| is_definitive | No | Filter to REAL deals only — deal_stage IN (definitive, pending, closed), excluding rumor/talks/loi/terminated. The 'how much is real vs rumor' filter (mars 2026-07-26; hits a partial index). Default: no filter (returns all stages). Each row also carries `deal_stage` + `is_definitive` so you can see the finer ladder. | |
| min_freshness | No | Filter to deals mars saw at-or-fresher-than this class (by first_seen_at): fresh <7d / recent <30d / aging <90d / stale = no filter. Every row carries `first_seen_at` + server-computed `days_since_first_seen` + `freshness_class` so you can judge staleness before trading on it. For the tightest Kalshi ACQ filter: is_definitive=true + min_freshness='fresh'. |