Skip to content
Load Factor Docs
Open Load Factor

MCP Tool

Search incentive programs

Find US clean-energy incentive and policy programs.

  • MCP
  • Read-only
  • Updated

Declaration

MCP tool
search_incentives(
    state?: string,
    zip?: string,
    technology?: string,
    sector?: string,
    program_type?: string,
    category?: string,
    query?: string,
    capacity_mw?: number,
    include_ineligible?: boolean,
    include_expired?: boolean,
    limit?: integer,
    offset?: integer
)

Parameters

statestringOptional
Two-letter state code, e.g. IL. Use US for federal programs.
zipstringOptional
5-digit zip: programs mapped to it plus statewide programs of its state, plus residential incentives for the zip.
technologystringOptional
Technology. hybrid = solar or wind tags; storage = DSIRE battery (Lithium-ion) tag. Queue fuel names (Solar, Battery Storage, Offshore Wind) are accepted.Allowed: solar, wind, storage, hybrid, geothermal, hydro, biomass, fuel_cell
sectorstringOptional
Eligible sector. Only programs with DSIRE sector tags can match (policies usually have none).Allowed: residential, commercial, industrial, agricultural, nonprofit, government, utility, low_income, tribal
program_typestringOptional
DSIRE program type, exact name, e.g. Rebate Program, Net Metering, Renewables Portfolio Standard, Property Tax Incentive, Grant Program.
categorystringOptional
financial_incentive = money (rebates, grants, loans, tax); regulatory_policy = rules (net metering, RPS, interconnection); any (default).Allowed: financial_incentive, regulatory_policy, anyDefault: any
querystringOptional
Text in the program name, summary or administrator.
capacity_mwnumberOptional
Project size in MW. Programs whose DSIRE eligible system size or system capacity limit caps below it are left out (see include_ineligible); over 1 MW also drops programs only for residential/low-income/multifamily.
include_ineligiblebooleanOptional
With capacity_mw: keep programs whose stated size cap is below capacity_mw, listed last with size_eligible=false.Default: false
include_expiredbooleanOptional
Include programs whose end date has passed.Default: false
limitintegerOptional
Programs to return (max 50).Default: 15
offsetintegerOptional
Skip this many programs (paging).Default: 0

Return Value

Returns {summary, total, by_type, next_offset, results, freshness}, plus residential_incentives for a zip search.

Discussion

Find US clean-energy incentive and policy programs (DSIRE: state, local, utility and federal rebates, grants, loans, tax incentives, net metering, interconnection rules, RPS, solar/wind siting rules).

Filters combine with AND. zip returns programs mapped to that zip plus statewide programs of its state, and a separate short list of residential home-electrification incentives for that zip (Rewiring America). technology matches DSIRE technology tags; untagged policy programs that apply to it (net metering, interconnection, RPS, access/permitting rules, storage targets) are kept and marked technology_match="policy". capacity_mw leaves out programs whose DSIRE eligible system size / system capacity limit caps below that size (parsed from DSIRE text; include_ineligible lists them flagged size_eligible=false) and, over 1 MW, residential/low-income-only programs. Expired programs are hidden unless include_expired. Each row gives key amounts with dollars and percentages kept separate, size limits, dates and a url; total counts all matches. Contact e-mails/phones in program text are withheld (get_incentive_program gives the program's website).

Returns {summary, total, by_type, next_offset, results, freshness}, plus residential_incentives for a zip search. Results are ordered by state, financial incentives first; each has id (for get_incentive_program), gi_uid (its Load Factor ID, when assigned), name, type, level, administrator, scope, start/end dates, a short summary and incentive (largest percent and dollar amounts, key terms). freshness dates the DSIRE read.

Use this to list programs; use get_incentive_program for one program's full terms. Results only cover the states in your Load Factor ISO footprint.

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_incentives",
    "arguments": {
      "state": "TX",
      "technology": "solar"
    }
  }
}

Availability

Listed to accounts with the Incentives module. Results follow your Load Factor permissions (ISOs, detail level, evidence depth and rows per call). See Access & permissions.