MCP Tool
Search incentive programs
Find US clean-energy incentive and policy programs.
- MCP
- Read-only
- Updated
Declaration
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:
What solar incentives and policies apply in Texas?
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_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.