MCP Tool
Search permit filings
Search state siting and regulatory dockets filed for renewable projects.
- MCP
- Read-only
- Updated
Declaration
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:
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):
{
"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.