Origin-signed US political data: 25,546 officials, bills, votes, positions with sources.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Compare an official's stated positions against their actual roll-call votes, per topic — what they SAY vs how they VOTED, both source-linked. Does NOT label agreement/contradiction (you judge and cite); surfaces the juxtaposition no unsigned source can. Use official id.
Official ID
Compare an official's stated positions against their actual roll-call votes, per topic — what they SAY vs how they VOTED, both source-linked. Does NOT label agreement/contradiction (you judge and cite); surfaces the juxtaposition no unsigned source can. Use official id.
| Argument | Type | Description |
|---|---|---|
| id* | integer | Official ID |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"description": "Official ID"
}
}
}Details of a US bill or resolution: vote breakdown, sponsors, cosponsors, status, and origin proof. Returns metadata, a short text excerpt, and a text index by default; full legislative text is omitted because omnibus bills exceed typical token caps. The include_text parameter controls whether the complete text is returned in a single response.
| Argument | Type | Description |
|---|---|---|
| bill_id* | string | Bill ID (e.g. hr3424-119 for House bill 3424 in 119th Congress) |
| include_text | string | excerpt (default): metadata + ~1.2KB head + text index. none: metadata + index only. full: entire full_text (may exceed the token cap for large bills). |
{
"type": "object",
"required": [
"bill_id"
],
"properties": {
"bill_id": {
"type": "string",
"description": "Bill ID (e.g. hr3424-119 for House bill 3424 in 119th Congress)"
},
"include_text": {
"enum": [
"none",
"excerpt",
"full"
],
"type": "string",
"default": "excerpt",
"description": "excerpt (default): metadata + ~1.2KB head + text index. none: metadata + index only. full: entire full_text (may exceed the token cap for large bills)."
}
}
}One signed, bounded slice of a bill's full legislative text, addressed by part number or section label. Each response carries part and total_parts, next_part, the slice's part_sha256, and the whole-bill content_hash. Parts 1 through total_parts concatenated in order hash to content_hash, so a bill too large to return in a single response remains verifiable as complete and unaltered.
| Argument | Type | Description |
|---|---|---|
| part | integer | 1-based part number. Response tells you total_parts and next_part. |
| bill_id* | string | Bill ID (e.g. hr7148-119) |
| section | string | Jump to a section by label instead of part, e.g. "2", "SEC. 2", or "preamble". Overrides part. |
| max_chars | integer | Max characters per part (2000–60000). Larger = fewer parts but bigger responses. |
{
"type": "object",
"required": [
"bill_id"
],
"properties": {
"part": {
"type": "integer",
"default": 1,
"description": "1-based part number. Response tells you total_parts and next_part."
},
"bill_id": {
"type": "string",
"description": "Bill ID (e.g. hr7148-119)"
},
"section": {
"type": "string",
"description": "Jump to a section by label instead of part, e.g. \"2\", \"SEC. 2\", or \"preamble\". Overrides part."
},
"max_chars": {
"type": "integer",
"default": 30000,
"description": "Max characters per part (2000–60000). Larger = fewer parts but bigger responses."
}
}
}Section index for a bill: every "SEC. N" heading with its character offset and length, plus the whole-bill origin hash (content_hash) and total text length. A small response that describes the structure of a large bill.
| Argument | Type | Description |
|---|---|---|
| bill_id* | string | Bill ID (e.g. hr7148-119) |
{
"type": "object",
"required": [
"bill_id"
],
"properties": {
"bill_id": {
"type": "string",
"description": "Bill ID (e.g. hr7148-119)"
}
}
}Search bills by topic, sponsor, status, or congress. Returns bill metadata and whether full text is available.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| topic | string | Topic keyword (e.g. crypto, defense, healthcare) |
| status | string | Bill status: introduced, committee, passed_house, passed_senate, enacted |
| sponsor | string | Sponsor name or bioguide ID |
| congress | integer | Congress number (119 = 2025-2026) |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20
},
"topic": {
"type": "string",
"description": "Topic keyword (e.g. crypto, defense, healthcare)"
},
"status": {
"type": "string",
"description": "Bill status: introduced, committee, passed_house, passed_senate, enacted"
},
"sponsor": {
"type": "string",
"description": "Sponsor name or bioguide ID"
},
"congress": {
"type": "integer",
"default": 119,
"description": "Congress number (119 = 2025-2026)"
}
}
}Compare multiple politicians side-by-side on a bridge page — positions, party, office, campaign finance. Optionally filter to a specific topic.
| Argument | Type | Description |
|---|---|---|
| hash* | string | Bridge page session hash |
| title | string | Title for this comparison |
| topic | string | Optional topic to focus comparison on |
| official_ids* | array | Array of official IDs to compare |
{
"type": "object",
"required": [
"hash",
"official_ids"
],
"properties": {
"hash": {
"type": "string",
"description": "Bridge page session hash"
},
"title": {
"type": "string",
"description": "Title for this comparison"
},
"topic": {
"type": "string",
"description": "Optional topic to focus comparison on"
},
"official_ids": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Array of official IDs to compare"
}
}
}Create a citizen bridge page — a personalized workspace for tracking representatives, comparing positions, and taking action (write letters, log calls). Returns a shareable URL that any AI agent can collaborate on. Optionally auto-populates with the citizen's state representatives.
| Argument | Type | Description |
|---|---|---|
| zip | string | ZIP code for precise district matching |
| state | string | State abbreviation — auto-adds federal representatives |
| topics | string | Comma-separated topics of interest (e.g. Healthcare,Climate) |
{
"type": "object",
"properties": {
"zip": {
"type": "string",
"description": "ZIP code for precise district matching"
},
"state": {
"type": "string",
"description": "State abbreviation — auto-adds federal representatives"
},
"topics": {
"type": "string",
"description": "Comma-separated topics of interest (e.g. Healthcare,Climate)"
}
}
}Draft a letter to a politician on the citizen's bridge page. The letter gets an origin hash for proof of content. Returns delivery options (email, web form, USPS, phone).
| Argument | Type | Description |
|---|---|---|
| body* | string | Letter body text |
| hash* | string | Bridge page session hash |
| subject | string | Letter subject |
| action_type | string | |
| official_id* | integer | Official to write to |
{
"type": "object",
"required": [
"hash",
"official_id",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Letter body text"
},
"hash": {
"type": "string",
"description": "Bridge page session hash"
},
"subject": {
"type": "string",
"description": "Letter subject"
},
"action_type": {
"enum": [
"letter",
"email",
"call",
"meeting"
],
"type": "string",
"default": "letter"
},
"official_id": {
"type": "integer",
"description": "Official to write to"
}
}
}Current state of a citizen bridge workspace: tracked officials, saved comparisons, drafted actions, and messages.
| Argument | Type | Description |
|---|---|---|
| hash* | string | Bridge page session hash |
| agent_id | string | Your agent identifier for multi-agent tracking |
{
"type": "object",
"required": [
"hash"
],
"properties": {
"hash": {
"type": "string",
"description": "Bridge page session hash"
},
"agent_id": {
"type": "string",
"description": "Your agent identifier for multi-agent tracking"
}
}
}Get all current officials for a US state — federal senators and representatives, state legislators, and any indexed local officials. Organized by government level.
| Argument | Type | Description |
|---|---|---|
| state* | string | State abbreviation (e.g. FL, CA, TX) |
{
"type": "object",
"required": [
"state"
],
"properties": {
"state": {
"type": "string",
"description": "State abbreviation (e.g. FL, CA, TX)"
}
}
}Get a candidate's Campaign Data Standard (CDS) feed: a single machine-readable record of who they are, the offices they hold and seek, their positions in their own words (each source-linked), their voting record by reference, and declared data gaps. This is the standardized, signed feed an AI or reporter uses to grab a candidate's positions and verify they are genuine. Every MCP response is signed; the standalone signed feed is also at /official/{id}/candidate.json. Tier is "rootz-compiled" until the campaign claims and signs it ("candidate-signed").
| Argument | Type | Description |
|---|---|---|
| id | integer | Official ID (from politics_search) |
| expand | boolean | Deliver more positions inline (larger response). Default false = bounded for AI consumption. |
| bioguide_id | string | Bioguide ID (alternative to id) |
| positions_limit | integer | Max positions in the delivered feed (default 15, max 500). The complete signed feed (all positions) is always at signed_feed_url. |
| positions_offset | integer | Pagination offset for positions. |
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Official ID (from politics_search)"
},
"expand": {
"type": "boolean",
"description": "Deliver more positions inline (larger response). Default false = bounded for AI consumption."
},
"bioguide_id": {
"type": "string",
"description": "Bioguide ID (alternative to id)"
},
"positions_limit": {
"type": "integer",
"description": "Max positions in the delivered feed (default 15, max 500). The complete signed feed (all positions) is always at signed_feed_url."
},
"positions_offset": {
"type": "integer",
"description": "Pagination offset for positions."
}
}
}Registered federal candidates for the 2026 election cycle, filterable by state, office (senate, house, president), party, or presence of a campaign URL. Returns campaign website, social media links, FEC data, and position and speech counts.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (default 50) |
| party | string | Filter by party (Democrat, Republican, Libertarian, etc.) |
| state | string | Two-letter state code (e.g. ME, CA, TX) |
| office | string | Filter by office |
| offset | integer | Pagination offset |
| has_url | boolean | Only return candidates with campaign websites |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"description": "Max results (default 50)"
},
"party": {
"type": "string",
"description": "Filter by party (Democrat, Republican, Libertarian, etc.)"
},
"state": {
"type": "string",
"description": "Two-letter state code (e.g. ME, CA, TX)"
},
"office": {
"enum": [
"senate",
"house",
"president"
],
"type": "string",
"description": "Filter by office"
},
"offset": {
"type": "integer",
"default": 0,
"description": "Pagination offset"
},
"has_url": {
"type": "boolean",
"description": "Only return candidates with campaign websites"
}
}
}Get recent changes detected across all politicians — position shifts, website updates, new data. Each change links to the before/after snapshots with origin proof.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| since | string | ISO date to filter changes after (e.g. 2026-05-01) |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50
},
"since": {
"type": "string",
"description": "ISO date to filter changes after (e.g. 2026-05-01)"
}
}
}Coverage map: per-state, per-dataset completeness (officials by level, positions, finance, state-legislative votes). Shows WHERE the data is deep (federal — complete) vs sparse (local). Use it to know whether silence means "no data captured" rather than "nothing there".
No arguments.
{
"type": "object",
"properties": {}
}Creates a Just the Facts watchlist bound to an email address, covering any combination of specific officials, issue topics, and a town with state for local meetings, agendas, and minutes. Sends a double-opt-in confirmation email and returns the bridge workspace URL.
| Argument | Type | Description |
|---|---|---|
| name | string | Watchlist name |
| town | string | Town/city to track local meetings (e.g. Fort Myers) |
| email* | string | Subscriber email (required) |
| state | string | 2-letter state for the town |
| topics | array | Issue topics (e.g. Crypto, Healthcare) |
| cadence | string | Digest frequency |
| officials | array | Official IDs to track |
| report_prompt | string | Plain-English brief for how the digest is written |
{
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string",
"description": "Watchlist name"
},
"town": {
"type": "string",
"description": "Town/city to track local meetings (e.g. Fort Myers)"
},
"email": {
"type": "string",
"description": "Subscriber email (required)"
},
"state": {
"type": "string",
"description": "2-letter state for the town"
},
"topics": {
"type": "array",
"items": {
"type": "string"
},
"description": "Issue topics (e.g. Crypto, Healthcare)"
},
"cadence": {
"enum": [
"daily",
"weekly"
],
"type": "string",
"description": "Digest frequency"
},
"officials": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Official IDs to track"
},
"report_prompt": {
"type": "string",
"description": "Plain-English brief for how the digest is written"
}
}
}Get the full transparency methodology — how we collect, assess, extract, sign, and verify political data. Includes quality assessment algorithm (signals + weights), trust levels, data sources, cron schedule, and what we can and cannot prove. Open and auditable.
No arguments.
{
"type": "object",
"properties": {}
}Search US municipalities (cities, towns, villages, counties). Every incorporated place in the US with coordinates. Filter by state, name, or type. Returns website, platform, meeting calendar, and board/commission info where available.
| Argument | Type | Description |
|---|---|---|
| name | string | Municipality name (partial match) |
| type | string | Place type: city, town, village, borough, county, cdp |
| limit | integer | Max results (default 30) |
| state | string | Two-letter state code (MA, CA, TX, etc.) |
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Municipality name (partial match)"
},
"type": {
"enum": [
"city",
"town",
"village",
"borough",
"county",
"cdp",
"place",
"charter_township"
],
"type": "string",
"description": "Place type: city, town, village, borough, county, cdp"
},
"limit": {
"type": "integer",
"default": 30,
"description": "Max results (default 30)"
},
"state": {
"type": "string",
"description": "Two-letter state code (MA, CA, TX, etc.)"
}
}
}Get full details for a specific official by ID — biography, party, office, policy positions, committee assignments, campaign finance, social media, and contact info. All data includes source URLs for verification.
| Argument | Type | Description |
|---|---|---|
| id | integer | Official ID from politics_search results |
| expand | boolean | Return the fuller record (larger response, untruncated detail). Default false = bounded for AI consumption. |
| bioguide_id | string | Congress.gov Bioguide ID (e.g. S000033 for Bernie Sanders) |
| positions_limit | integer | Max policy positions to return (default 15, max 250). Response is bounded so it fits any AI client tool-result limit. |
| positions_offset | integer | Pagination offset for positions (page with offset += limit). |
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Official ID from politics_search results"
},
"expand": {
"type": "boolean",
"description": "Return the fuller record (larger response, untruncated detail). Default false = bounded for AI consumption."
},
"bioguide_id": {
"type": "string",
"description": "Congress.gov Bioguide ID (e.g. S000033 for Bernie Sanders)"
},
"positions_limit": {
"type": "integer",
"description": "Max policy positions to return (default 15, max 250). Response is bounded so it fits any AI client tool-result limit."
},
"positions_offset": {
"type": "integer",
"description": "Pagination offset for positions (page with offset += limit)."
}
}
}Get origin archive statistics — total snapshots, changes detected, origin proofs recorded, unique URLs tracked. Shows the depth of the political wayback machine.
No arguments.
{
"type": "object",
"properties": {}
}Get one poll in full: pollster, sponsor, field dates, population, sample size, margin of error, mode, the VERBATIM question(s) asked, per-option toplines, the first-party source_url, and the signature (poll_proof) that binds the exact wording and numbers. This is the ground truth to check any claim about a poll against.
| Argument | Type | Description |
|---|---|---|
| id* | integer | Poll ID from politics_polls results |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"description": "Poll ID from politics_polls results"
}
}
}Search the SIGNED public-poll archive. Unlike aggregators, every poll keeps the EXACT question wording, population base (LV/RV/adults), sample size, margin of error, mode, and per-option toplines — first-party sourced, snapshot-hashed, and cryptographically signed (verifiable). Filter by race_key, state, subject (e.g. "approval", "Senate"), pollster, or since (ISO date). Returns a list; call politics_poll {id} for full detail + signature. Use this when a question hinges on what a poll ACTUALLY asked vs how it was reported.
| Argument | Type | Description |
|---|---|---|
| cycle | integer | Election/survey cycle year (e.g. 2026) |
| limit | integer | |
| since | string | Only polls whose field_end >= this ISO date (e.g. 2026-08-01) |
| state | string | 2-letter state (omit for national) |
| offset | integer | |
| subject | string | Subject substring (e.g. "approval", "TX Senate", "immigration") |
| pollster | string | Pollster substring (e.g. "Quinnipiac", "Emerson") |
| race_key | string | Stable contest key to get every poll of one race over time (e.g. us-pres-approval-trump) |
Policy positions across officials by topic, covering who supports or opposes issues such as crypto, stablecoins, AI, healthcare, and guns. Each position carries a source URL and origin hash. Returns compact records by default (id, name, party, state, stance, summary, source) with a total count; the compact parameter controls row detail and offset controls paging.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results per page. Compact: default 100, max 250. Full: default 25, max 50. |
| party | string | Filter by party (Republican, Democrat) |
| state | string | Filter by state (2-letter code) |
| topic* | string | Policy topic label — use exact stored labels: Cryptocurrency, Technology, Healthcare, Immigration, Climate, Gun Control, Abortion, Taxes, Economy, Education, National Security, Housing, Criminal Justice, Social Security, Voting Rights, Agriculture, Trade |
| offset | integer | Pagination offset. Response includes total; page by offset += limit. |
| compact | boolean | Compact mode (default). Small bounded record per position; use with offset to page. Set false for full rows (limit capped at 50). |
Get the complete origin proof chain for an official — every data source, content hash, quality assessment, snapshot history, and verification instructions. Proves where every piece of data came from.
| Argument | Type | Description |
|---|---|---|
| official_id* | integer | Official ID |
{
"type": "object",
"required": [
"official_id"
],
"properties": {
"official_id": {
"type": "integer",
"description": "Official ID"
}
}
}Representation lookup for a US ZIP code: both U.S. Senators, the U.S. House member for that ZIP's congressional district, and the state's statewide executives (governor, attorney general, and similar). Every official carries source_url (the capture origin) and source_link (a public page).
| Argument | Type | Description |
|---|---|---|
| zip* | string | 5-digit US ZIP code, e.g. 04101 |
{
"type": "object",
"required": [
"zip"
],
"properties": {
"zip": {
"type": "string",
"description": "5-digit US ZIP code, e.g. 04101"
}
}
}Resolve a messy name string (e.g. "Rep. Johnson", "cornyn") to a canonical official — returns the best match with a 0-1 confidence score and ranked alternatives. Use this first when you have a name but not an ID; then call politics_official with best.id. Add state to disambiguate.
| Argument | Type | Description |
|---|---|---|
| name* | string | Name to resolve (partial/with title/lowercase all OK) |
| level | string | Government level to disambiguate |
| state | string | State abbreviation to disambiguate (e.g. TX) |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Name to resolve (partial/with title/lowercase all OK)"
},
"level": {
"enum": [
"federal",
"state",
"county",
"municipal",
"school"
],
"type": "string",
"description": "Government level to disambiguate"
},
"state": {
"type": "string",
"description": "State abbreviation to disambiguate (e.g. TX)"
}
}
}Search for politicians and elected officials across all levels of US government — federal, state, county, municipal. Filter by name, state, party, level, chamber, or office title. Returns officials with their current office, party, and contact info.
| Argument | Type | Description |
|---|---|---|
| name | string | Official name (partial match, e.g. "Sanders" or "Alexandria") |
| level | string | Government level |
| limit | integer | Max results (default 50) |
| party | string | Party name (e.g. Democrat, Republican, Independent) |
| state | string | State abbreviation (e.g. FL, NY, CA) |
| office | string | Office title (e.g. Senator, Mayor, Governor, Town Clerk) |
| offset | integer | Pagination offset |
| status | string | Status (default: active + candidate) |
| chamber | string | Legislative chamber |
Search Congressional Record floor speeches by official, topic, date range, or keyword. Returns verbatim text from the official government record with origin proof hash. Every speech is directly citable with a GPO source URL.
| Argument | Type | Description |
|---|---|---|
| text | string | Full-text search within speech content |
| limit | integer | Max results |
| topic | string | Topic (Cryptocurrency, Healthcare, Immigration, etc.) |
| chamber | string | Filter by chamber |
| date_to | string | End date ISO |
| date_from | string | Start date ISO (e.g. 2025-01-03) |
| bioguide_id | string | Bioguide ID (e.g. L000571 for Lummis, S001184 for Tim Scott) |
| official_id | integer | Official ID from politics_search |
{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "Full-text search within speech content"
},
"limit": {
"type": "integer",
"default": 20,
"description": "Max results"
},
"topic": {
"type": "string",
"description": "Topic (Cryptocurrency, Healthcare, Immigration, etc.)"
},
"chamber": {
"enum": [
"house",
"senate"
],
"type": "string",
"description": "Filter by chamber"
},
"date_to": {
"type": "string",
"description": "End date ISO"
},
"date_from": {
"type": "string",
"description": "Start date ISO (e.g. 2025-01-03)"
},
"bioguide_id": {
"type": "string",
"description": "Bioguide ID (e.g. L000571 for Lummis, S001184 for Tim Scott)"
},
"official_id": {
"type": "integer",
"description": "Official ID from politics_search"
}
}
}Search state legislature votes across 26+ US states. Filter by state, topic, or date. Returns bill title, vote result, yes/no counts.
| Argument | Type | Description |
|---|---|---|
| days | integer | Look back N days (default 30, max 365) |
| limit | integer | Max results (default 30, max 100) |
| state | string | Two-letter state code (CA, TX, NY, etc.) |
| topic | string | Topic filter (Healthcare, Economy, Education, etc.) |
| bill_id | string | Specific bill identifier (e.g. HB 1234) |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"default": 30,
"description": "Look back N days (default 30, max 365)"
},
"limit": {
"type": "integer",
"default": 30,
"description": "Max results (default 30, max 100)"
},
"state": {
"type": "string",
"description": "Two-letter state code (CA, TX, NY, etc.)"
},
"topic": {
"type": "string",
"description": "Topic filter (Healthcare, Economy, Education, etc.)"
},
"bill_id": {
"type": "string",
"description": "Specific bill identifier (e.g. HB 1234)"
}
}
}Get summary statistics for the politics.rootz.global database — total officials, breakdown by level, party, state, and chamber. Shows coverage completeness.
No arguments.
{
"type": "object",
"properties": {}
}Get the full origin timeline for a politician — every page snapshot, every position change, every data source with hash proof. The political wayback machine. Shows what changed, when, and where the data came from.
| Argument | Type | Description |
|---|---|---|
| id* | integer | Official ID |
| limit | integer |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"description": "Official ID"
},
"limit": {
"type": "integer",
"default": 100
}
}
}{
"type": "object",
"properties": {
"cycle": {
"type": "integer",
"description": "Election/survey cycle year (e.g. 2026)"
},
"limit": {
"type": "integer",
"default": 50
},
"since": {
"type": "string",
"description": "Only polls whose field_end >= this ISO date (e.g. 2026-08-01)"
},
"state": {
"type": "string",
"description": "2-letter state (omit for national)"
},
"offset": {
"type": "integer",
"default": 0
},
"subject": {
"type": "string",
"description": "Subject substring (e.g. \"approval\", \"TX Senate\", \"immigration\")"
},
"pollster": {
"type": "string",
"description": "Pollster substring (e.g. \"Quinnipiac\", \"Emerson\")"
},
"race_key": {
"type": "string",
"description": "Stable contest key to get every poll of one race over time (e.g. us-pres-approval-trump)"
}
}
}{
"type": "object",
"required": [
"topic"
],
"properties": {
"limit": {
"type": "integer",
"default": 100,
"description": "Max results per page. Compact: default 100, max 250. Full: default 25, max 50."
},
"party": {
"type": "string",
"description": "Filter by party (Republican, Democrat)"
},
"state": {
"type": "string",
"description": "Filter by state (2-letter code)"
},
"topic": {
"type": "string",
"description": "Policy topic label — use exact stored labels: Cryptocurrency, Technology, Healthcare, Immigration, Climate, Gun Control, Abortion, Taxes, Economy, Education, National Security, Housing, Criminal Justice, Social Security, Voting Rights, Agriculture, Trade"
},
"offset": {
"type": "integer",
"default": 0,
"description": "Pagination offset. Response includes total; page by offset += limit."
},
"compact": {
"type": "boolean",
"default": true,
"description": "Compact mode (default). Small bounded record per position; use with offset to page. Set false for full rows (limit capped at 50)."
}
}
}{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Official name (partial match, e.g. \"Sanders\" or \"Alexandria\")"
},
"level": {
"enum": [
"federal",
"state",
"county",
"municipal",
"school"
],
"type": "string",
"description": "Government level"
},
"limit": {
"type": "integer",
"default": 50,
"description": "Max results (default 50)"
},
"party": {
"type": "string",
"description": "Party name (e.g. Democrat, Republican, Independent)"
},
"state": {
"type": "string",
"description": "State abbreviation (e.g. FL, NY, CA)"
},
"office": {
"type": "string",
"description": "Office title (e.g. Senator, Mayor, Governor, Town Clerk)"
},
"offset": {
"type": "integer",
"default": 0,
"description": "Pagination offset"
},
"status": {
"enum": [
"active",
"candidate",
"former",
"defeated"
],
"type": "string",
"description": "Status (default: active + candidate)"
},
"chamber": {
"enum": [
"senate",
"house",
"council",
"board"
],
"type": "string",
"description": "Legislative chamber"
}
}
}