Skip to content
Load Factor Docs
Open Load Factor

MCP Tool

Search NY distributed generation

Search New York distributed-generation interconnection applications from the NY DPS utility queues.

  • MCP
  • Read-only
  • Updated

Declaration

MCP tool
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:

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