# Search Load Factor Insights articles (`search_insights`)

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

Search Load Factor Insights: the research articles Load Factor publishes at loadfactorenergy.com/insights (interconnection-queue analysis, market and deal intelligence, policy, methodology). `query` is matched against each article's title, summary, topic, keywords and full text; filter by topic, ISO tag or publication date. Returns each article's id (article:<slug>), title, summary, topic, ISO, author, date, reading time and public link, title matches first and then newest first, plus the topics that exist. Pass an id to `fetch` for the whole article, and cite articles by their url.

## Parameters

| Parameter | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `query` | string | no | Words to find in the title, summary, topic, keywords or text, e.g. 'battery storage', 'FERC Order 2023'. |  |  |
| `topic` | string | no | Topic, partial match, e.g. 'Market Analysis', 'Storage', 'Methodology'. |  |  |
| `iso` | string | no | ISO the article is tagged to (MISO, ERCOT, PJM, SPP, CAISO, ISO-NE). Most articles cover several markets and carry no tag; use query for those. |  |  |
| `published_from` | string | no | Earliest publication date: YYYY, YYYY-MM or YYYY-MM-DD. |  |  |
| `published_to` | string | no | Latest publication date: YYYY, YYYY-MM or YYYY-MM-DD. |  |  |
| `limit` | integer | no | Articles to return (max 50). |  | 10 |
| `offset` | integer | no | Skip this many articles (paging). |  | 0 |

## Example

Ask your assistant: "What has Load Factor published about battery storage?"

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_insights",
    "arguments": {
      "query": "battery storage",
      "limit": 5
    }
  }
}
```

## 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).
