Skip to content
Load Factor Docs
Open Load Factor

MCP Tool

Search deals & news

Search deal flow and project news, newest first.

  • MCP
  • Read-only
  • Updated

Declaration

MCP tool
search_deals_news(
    company?: string,
    query?: string,
    event_type?: string[],
    category?: string,
    deal_type?: string,
    state?: string,
    iso?: string,
    plant_id?: integer,
    project_number?: string,
    date_from?: string,
    date_to?: string,
    sources?: string,
    include_low_relevance?: boolean,
    limit?: integer,
    offset?: integer
)

Parameters

companystringOptional
Company name (substring), matched against deal parties (buyer, seller, developer, lender, sponsor, financier), organisations named in the article, and the linked plant's developer/parent.
querystringOptional
Text to find in the headline or snippet, e.g. 'battery', 'data center', 'tax equity'.
event_typestring[]Optional
News event type(s), one value or a list. Deals: ACQUISITION, PPA_SIGNED, FUNDING, LAND_SALE. Development: CONSTRUCTION, APPROVED, FILED, PUBLIC_HEARING, INTERCONNECTION_UPDATE. Opposition/legal: OPPOSITION, LAWSUIT, ENV_CHALLENGE, PERMIT_APPEAL, ZONING_DENIAL, MORATORIUM, SETTLEMENT. Other: GRID_TARIFF, PARTNERSHIP, INVESTIGATION, SUSPENSION. Case-insensitive; 'M&A' / 'acquisition' mean ACQUISITION, 'PPA' means PPA_SIGNED, 'financing' means FUNDING. ACQUISITION/PPA_SIGNED/FUNDING also select matching curated deal items.Allowed: ACQUISITION, PPA_SIGNED, FUNDING, CONSTRUCTION, APPROVED, FILED, PUBLIC_HEARING, INTERCONNECTION_UPDATE, OPPOSITION, LAWSUIT, ENV_CHALLENGE, PERMIT_APPEAL, ZONING_DENIAL, MORATORIUM, LAND_SALE, GRID_TARIFF, SETTLEMENT, PARTNERSHIP, INVESTIGATION, SUSPENSION
categorystringOptional
News category. deals also keeps curated deal items; other categories return news only.Allowed: deals, development, regulatory, grid, hazards, industry
deal_typestringOptional
Shortcut across all sources: m_and_a (also 'M&A'), ppa, financing (project finance, debt, tax equity, credit transfers), opposition (opposition, lawsuits, moratoria, land-use denials, permit appeals, environmental challenges; news only), any (any deal).Allowed: m_and_a, ppa, financing, opposition, any
statestringOptional
Two-letter state code(s), comma-separated, e.g. 'TX' or 'IL,IN'. Matches the article's extracted state (else the linked plant's) or the deal's state.
isostringOptional
ISO/region, or comma-separated list: PJM, MISO, ERCOT, SPP, CAISO, NYISO, ISO-NE, West, Southeast. Returns only items tagged with it.
plant_idintegerOptional
EIA plant ID (6002 or plant:6002): news linked to that operating plant.
project_numberstringOptional
Queue project number (J4196 or project:J4196): news for the project's matched EIA plant(s) plus curated deals matched to it.
date_fromstringOptional
On/after this date: YYYY-MM-DD, YYYY-MM or YYYY (first day of the month/year). Default: 24 months ago (no lower bound when plant_id or project_number is set).
date_tostringOptional
On/before this date: YYYY-MM-DD, YYYY-MM or YYYY (last day of the month/year). Default: today.
sourcesstringOptional
Which sources to search: all (default), news, or the curated deal sources.Allowed: all, newsDefault: all
include_low_relevancebooleanOptional
Include unclassified news and articles the classifier scored below 0.5 (mostly articles linked to the wrong plant). Default false.Default: false
limitintegerOptional
Items to return (max 50).Default: 15
offsetintegerOptional
Skip this many items (paging).Default: 0

Return Value

Returns totals per source, data freshness, and an id + url per item; pass the id to fetch for the full record.

Discussion

Search deal flow and project news, newest first: M&A, PPAs, financings, construction and approval milestones, grid and hazard events, and local opposition (lawsuits, moratoria, land-use denials).

Merges three sources: plant-linked news articles (classified by event type, with extracted buyer/seller/value/MW and the linked EIA plant), curated deal transactions (sponsor, counterparty, value, MW, matched queue project, a short excerpt and source links) and third-party deal headlines (title and link only). Filter by company, text, event_type, category, deal_type shortcut, state, ISO, EIA plant (plant_id, e.g. 6002 or plant:6002), queue project (e.g. J4196 or project:J4196) and date (YYYY, YYYY-MM or YYYY-MM-DD; default last 24 months; all dates when plant_id or project_number is set). Returns totals per source, data freshness, and an id + url per item; pass the id to fetch for the full record.

Totals count articles and deal records, not distinct transactions: several outlets covering one deal are separate items, and a curated deal can repeat a news item. Items that look like a repeat of an earlier item on the same page carry likely_same_event_as; de-duplicate before counting deals.

Use this for what happened and when. Use search_projects / get_project for who is developing a queue project, find_companies for company name variants, and the PPA tools for FERC-reported contract prices and offtakers.

Example

Ask your assistant:

It would call the tool with a request like this one (your client builds and sends it for you):

tools/call request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_deals_news",
    "arguments": {
      "iso": "ERCOT",
      "deal_type": "ppa"
    }
  }
}

Availability

Listed to accounts with the Developer Tracker module. Results follow your Load Factor permissions (ISOs, detail level, evidence depth and rows per call). See Access & permissions.