Skip to content
Load Factor Docs
Open Load Factor

MCP Tool

Search permit filings

Search state siting and regulatory dockets filed for renewable projects.

  • MCP
  • Read-only
  • Updated

Declaration

MCP tool
search_permits(
    state?: string,
    applicant?: string,
    status?: string,
    fuel?: string,
    project_number?: string,
    query?: string,
    linked_only?: boolean,
    limit?: integer,
    offset?: integer
)

Parameters

statestringOptional
Two-letter state code. Only VA has data today.
applicantstringOptional
Filing company name (substring), usually the project LLC, e.g. 'Cassius Blue Solar'.
statusstringOptional
Docket status: pending (open), closed, or any (default).Allowed: pending, closed, anyDefault: any
fuelstringOptional
Fuel parsed from the docket caption (solar+storage filings are tagged storage). Queue fuel names (Solar, Battery Storage) are accepted.Allowed: solar, wind, storage
project_numberstringOptional
Load Factor queue project number the docket is linked to, e.g. AE2-094 (search's project:<id> works too).
querystringOptional
Text in the docket description or case number, e.g. 'Augusta County', 'CPCN', 'PUR-2024'.
linked_onlybooleanOptional
Only dockets linked to a Load Factor queue project.Default: false
limitintegerOptional
Rows to return (max 100; your plan may cap lower).Default: 25
offsetintegerOptional
Skip this many rows (paging).Default: 0

Return Value

Returns {summary, total, next_offset, results, freshness}.

Discussion

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.

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_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.