# Search permit filings (`search_permits`)

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

Search state siting and regulatory dockets filed for renewable projects. Coverage today is Virginia State Corporation Commission (SCC) cases only (PJM territory): certificates of public convenience and necessity (CPCN) for solar, wind and storage facilities, facility approvals, energy-storage permits, and shared-solar subscriber-organization licenses. Dockets the source mis-tagged (telecom, insurance, contractor violations) and fossil generating-facility dockets are left out.

Filter by applicant (the filing company, usually the project LLC), status, fuel, linked queue project or description text. Rows are newest first and include the SCC case number and docket link (`url`). `linked_project` is an automated link to a Load Factor queue project, shown only when it passes basic plausibility checks; verify it before relying on it. For queue data use search_projects or get_project.

Returns {summary, total, next_offset, results, freshness}. Each row has `case_number`, `applicant`, `docket_kind` (read from the caption), `status`, `fuel`, `filed`, `description`, `url`, and `mw` / `county` when the caption states them. `linked_project` (queue id, ISO, fuel, MW, status) is inferred, not verified.

## Parameters

| Parameter | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `state` | string | no | Two-letter state code. Only VA has data today. |  |  |
| `applicant` | string | no | Filing company name (substring), usually the project LLC, e.g. 'Cassius Blue Solar'. |  |  |
| `status` | string | no | Docket status: pending (open), closed, or any (default). | pending, closed, any | any |
| `fuel` | string | no | Fuel parsed from the docket caption (solar+storage filings are tagged storage). Queue fuel names (Solar, Battery Storage) are accepted. | solar, wind, storage |  |
| `project_number` | string | no | Load Factor queue project number the docket is linked to, e.g. AE2-094 (search's project:<id> works too). |  |  |
| `query` | string | no | Text in the docket description or case number, e.g. 'Augusta County', 'CPCN', 'PUR-2024'. |  |  |
| `linked_only` | boolean | no | Only dockets linked to a Load Factor queue project. |  | false |
| `limit` | integer | no | Rows to return (max 100; your plan may cap lower). |  | 25 |
| `offset` | integer | no | Skip this many rows (paging). |  | 0 |

## Example

Ask your assistant: "Show recent Virginia permit filings for renewable projects."

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_permits",
    "arguments": {
      "state": "VA"
    }
  }
}
```

## Availability

Listed to accounts with the Permits module. Serves PJM data only, so it is hidden from accounts without PJM 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).
