List Races
list_racesEvery federal race in a state for a cycle (the Senate seat if any, and each House district) with how many distinct people registered with the FEC and who the sitting officeholder is (incumbent; incumbent_note says when the seat is open and they are not a candidate). Use it to find the district number before calling race_matchup.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"state": "Iowa"
},
"name": "list_races"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cycle | No | Election year, even. Default 2026. | |
| state | Yes | US state: postal code ("IA") or full name. | |
| office | No | Optional: "house" or "senate" to restrict. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| cycle | No | ||
| races | No | ||
| state | No | ||
| source | No | ||
| data_as_of | No | ||
| races_total | No | ||
| data_as_of_note | No |