MCP Tool
Search NY distributed generation
Search New York distributed-generation interconnection applications from the NY DPS utility queues.
- MCP
- Read-only
- Updated
Declaration
search_dg_projects(
county?: string,
utility?: string,
zip?: string,
substation?: string,
zone?: string,
technology?: string,
status?: string,
project_type?: string,
developer?: string,
min_kw?: number,
group_by?: string,
sort?: string,
dg_id?: string,
project_number?: string,
limit?: integer,
offset?: integer
)Parameters
countystringOptional- NY county name(s), comma-separated, e.g. 'Albany' or 'Kings,Queens'. Boroughs map to counties.
utilitystringOptional- Utility: Con Edison, PSEG Long Island, National Grid, Central Hudson, NYSEG, Orange & Rockland, RG&E.
zipstringOptional- 5-digit zip code.
substationstringOptional- Utility substation name (substring), e.g. 'Jamaica'.
zonestringOptional- NYISO load zone letter A-K or name, e.g. J or 'Long Island'.
technologystringOptional- solar = PV only; storage = battery only; wind = wind only; hybrid = two or more of PV/storage/wind; other = small hydro. Queue fuel names (Solar, Battery Storage) are accepted.Allowed:
solar,storage,wind,hybrid,other statusstringOptional- live = everything except withdrawn (default); in_queue = approved + pending + under_study (not yet built); complete = interconnected; or one status; all.Allowed:
live,in_queue,complete,approved,pending,under_study,withdrawn,allDefault:live project_typestringOptional- Program/metering type as reported: net_metered, community_distributed_generation (CDG), remote_net_metered, rc, ssfa, fit, rfp, other, na.Allowed:
net_metered,community_distributed_generation,remote_net_metered,rc,ssfa,fit,rfp,other,na developerstringOptional- Developer/installer company name as reported by the utility (substring). Private individuals' names are withheld and never match.
min_kwnumberOptional- Minimum size in kW (PV + storage + wind + hydro).
group_bystringOptional- none = project rows (default); otherwise one row per group with project counts and kW.Allowed:
none,county,utility,substation,developer,status,technology,zone,project_typeDefault:none sortstringOptional- Rows: capacity (largest first, default), newest application, or project_number. Groups: capacity (kW) or count.Allowed:
capacity,count,newest,project_numberDefault:capacity dg_idstringOptional- One NY DG application id for full detail, e.g. NYSEG-29889 or CONED-SDG-95149 (search's dg:<id> works too); other filters are then ignored. Not an ISO queue id: for J4161-style ids use
get_project. project_numberstringOptional- Deprecated alias of dg_id.
limitintegerOptional- Rows or groups to return (max 100; your plan may cap lower).Default:
25 offsetintegerOptional- Skip this many rows/groups (paging).Default:
0
Return Value
Returns {summary, total, total_kw, kw_by_technology, by_status, next_offset, results, freshness}; with group_by, {total_projects, total_kw, total_groups, groups} instead, and with dg_id a single project with every reported field. kW are the nameplate values utilities reported (storage kW is not generation); freshness.snapshot_date is the NY DPS snapshot used.
Discussion
Search New York distributed-generation (DG) interconnection applications from the NY DPS utility queues (Con Edison, PSEG Long Island, National Grid, Central Hudson, NYSEG, Orange & Rockland, RG&E): rooftop, community and remote-net-metered solar, storage and small wind below the NYISO wholesale queue. About 330k applications, mostly residential net-metered solar.
Filter by county, utility, zip, substation, NYISO load zone, technology, status, project type (e.g. community_distributed_generation), developer/installer and minimum size. Set group_by to get project counts and kW by county, utility, substation, developer, status, technology, zone or project type instead of rows; use that for "how much / who leads" questions. Totals are computed over all matches. Pass dg_id (e.g. NYSEG-29889) for one application in full. Coordinates are zip-code centroids. Developer values that look like a private person's name (typically the homeowner on a residential system) or contain an e-mail/phone are withheld and cannot be searched.
Returns {summary, total, total_kw, kw_by_technology, by_status, next_offset, results, freshness}; with group_by, {total_projects, total_kw, total_groups, groups} instead, and with dg_id a single project with every reported field. kW are the nameplate values utilities reported (storage kW is not generation); freshness.snapshot_date is the NY DPS snapshot used.
For NYISO wholesale queue projects (ids like J4161) use search_projects / get_project. Needs NYISO in your Load Factor permissions.
Example
Ask your assistant:
How many New York distributed-generation applications does each utility have?
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_dg_projects",
"arguments": {
"group_by": "utility"
}
}
}Availability
Listed to accounts with the Developer Tracker or Map module. Serves NYISO data only, so it is hidden from accounts without NYISO access. Results follow your Load Factor permissions (ISOs, detail level, evidence depth and rows per call). See Access & permissions.