# Search Load Factor (`search`)

A read-only tool of the Load Factor MCP server (https://mcp.loadfactorenergy.com/mcp), in the Search & fetch group.

Search everything in Load Factor by free text: interconnection-queue project IDs and names, developers / SPVs, EIA power plants, deals and news, incentive programs, and Load Factor Insights articles (Load Factor's own published analysis).

Returns up to 22 typed results ({id, title, url}); pass an id to `fetch` for the full record (the specialised tools take the bare value: J4196, 6002). Exact queue IDs come first, then renewable queue projects (live before withdrawn; the developer's confidence tag in brackets), companies (live renewable queue projects counted as find_companies counts them), EIA plants, news and deals that name the query (unclassified and low-confidence stories left out), incentive programs, and up to two Load Factor Insights articles that discuss it. Company results carry `cik` when a Load Factor analyst linked the name to an SEC EDGAR registrant (fetch company:cik:<n> for that record). Short words (under 5 letters, no digits: AES, PPA) match whole words only. If the whole text matches little, the words are matched separately: ISO codes (PJM, MISO, ERCOT...), state names or upper-case codes (Texas, TX) and fuels (solar, wind, storage...) act as filters; capitalised words (names) must match and lower-case words only rank, so "NextEra solar Texas" finds NextEra's Texas solar projects; news and deals must then name the ISO / state. Results are limited to what your Load Factor plan can see. For filtered lists, counts or statistics use the specialised tools (search_projects, queue_stats, find_companies, search_plants, search_deals_news, search_incentives, search_insights).

## Parameters

| Parameter | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `query` | string | yes | Free text: queue ID (J4196, 23INR0103), project or company name, plant, county, POI substation, or deal/program keywords. Short questions work too, e.g. 'NextEra solar Texas'. |  |  |

## Example

Ask your assistant: "Search Load Factor for Apex Clean Energy."

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

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search",
    "arguments": {
      "query": "Apex Clean Energy"
    }
  }
}
```

## Availability

Listed to every account with MCP access. Results follow your Load Factor permissions (ISOs, detail level, evidence depth and rows per call). See [Access & permissions](https://loadfactorenergy.com/developers/mcp/access-and-permissions).
