A public MCP server,
so AI can answer civic questions correctly.

List upcoming US elections. Optionally filter by state (two-letter code) or OCD-ID, and a date floor.

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"elections.list_upcoming","arguments":{"state":"GA"}}}' \
  | jq .result.structuredContent

Given a longitude and latitude, return all political divisions (OCD-IDs) the point falls within: state, congressional district, state senate, state house, county, city, school district.

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"geo.lookup_divisions","arguments":{"lng":-73.9619,"lat":40.7128}}}' \
  | jq .result.structuredContent

Resolve a free-text address, ZIP code, or 'City, ST' string to a latitude/longitude. Uses ZIP Code Tabulation Area centroids and TIGER place-name centroids; no external API key needed.

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"geo.geocode","arguments":{"query":"94110"}}}' \
  | jq .result.structuredContent

Return voter ID requirements, vote-by-mail rules, online registration URL, and polling-place lookup URL for a US state. Covers all 50 states + DC.

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"civic.voting_info","arguments":{"state":"TX"}}}' \
  | jq .result.structuredContent

Return upcoming ballot items / contests for a given OCD-ID. Useful for Claude Desktop or ChatGPT to answer 'what's on the ballot for X?'.

Translate text between en/es/zh/ht/vi/ar/tl. The public MCP server returns a client-side resolution instruction; canvass clients run the model on-device.

Return all 50 US states + DC + territories with their two-letter codes and OCD division IDs. Useful for clients enumerating coverage.

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"civic.list_states","arguments":{}}}' \
  | jq .result.structuredContent

Return the authoritative state polling-place lookup URL for a state. Optionally supplies a ZIP centroid for context. The MCP server does NOT host a polling place database — the URL is the only source of truth.

Return state-level civic facts: capital, time zone(s), sitting governor (name + party), both U.S. senators with class numbers, U.S. House seat count, 2020 census population, and whether the state holds a 2025 statewide general election. Hand-verified data; refreshed periodically until the real-time feed lands.

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"civic.about_state","arguments":{"state":"OH"}}}' \
  | jq .result.structuredContent

List all U.S. House congressional districts in a state, with OCD-IDs and FIPS district codes. Sourced from US Census TIGER/Line 119th Congress shapefiles.

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"civic.house_districts","arguments":{"state":"NY"}}}' \
  | jq .result.structuredContent

Composite 'who represents me' lookup. Takes a ZIP, 'City, ST', or address; geocodes, resolves all 7 political divisions, and returns: governor + state senators (federal Class 1+2+3) + U.S. House district + state legislative districts + county + city. Single round-trip.

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"civic.my_reps","arguments":{"query":"94110"}}}' \
  | jq .result.structuredContent

Return a Wikipedia summary for a political division (state, congressional district, county, city, etc.) given its OCD-ID. Server-side cached up to 24h. Wikipedia content is CC BY-SA 4.0; preserve attribution.

Return UOCAVA / military / overseas voter information for a US state or territory: deadlines (registration, FPCA, FWAB, ballot return), local election office contacts, FPCA/FWAB/VBR ballot rules, and Q&A. Sourced from FVAP eVAG XML feeds; federal authority tier; cached server-side via the fvap_* tables.

Slim variant of civic.uocava_info: just the upcoming UOCAVA deadlines for a state. Most-asked question for military / overseas voters checking 'have I missed the cutoff?'.

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"civic.uocava_deadlines","arguments":{"state":"WV"}}}' \
  | jq .result.structuredContent

Live election returns from Clarity Elections (Civix), the vendor that powers GA, CO, PA, AZ, OH, MO, MN, NV, IN, WV and ~25 other states' results portals. Pass state (and optional county) to get the most recent election's contest-level summary with reporting progress and candidate vote totals. Pass electionId to query a specific past election. The data is republished from the state / county SOS — always cite back to that authority of record for certified results.

Live Florida county election results from the Florida ENR (voterfocus) network. Pass a 3-letter FL county code (e.g. DAD = Miami-Dade, BRO = Broward, ORA = Orange, DUV = Duval) and a known election ID. Returns contest-level summary with candidate vote totals, party labels, and precincts-reporting progress. Includes a cite-able 'data as of' Unix timestamp. NOTE: voterfocus removed automatic election-ID discovery in 2026 — callers must know the EID, typically from the county Supervisor of Elections site.

Generic GIS adapter — fetches county-published ArcGIS FeatureServer layers for drop-boxes, polling places, or sample-ballot zones. Pass a 5-digit county FIPS (e.g. 53033 = King County, WA; 42101 = Philadelphia, PA) and a task ('drop-box' default, 'polling-place', 'sample-ballot'). Returns GeoJSON-style features with point/polygon geometry + free-form attributes (name, address, hours, accessibility, ward/division). Wired for King County drop-boxes (84 features) and Philadelphia polling places (1,703 features). Fulton 13121 + Maricopa 04013 endpoints are TODO.

Statewide 2026 ballot measures (constitutional amendments, citizen initiatives, bond questions, etc) for a US state. Pass the 2-letter state code (e.g. 'GA', 'VA', 'LA'). Returns each measure's official ballot designation, official title (verbatim where the SOS has published it), turnout.app plain-language paraphrase clearly labeled as interpretation, measure type, source URL on the state SOS site, and verifiedAt date. Hand-curated from per-state SOS pages; primary states with measures: GA (3), VA (3+1 special), LA (6), SD (2), MI (1), AR (4), HI (1), NV (2), TN (3), ND (3), OK (1 special), VT (1), NC (1).

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"civic.ballot_measures","arguments":{"state":"VA"}}}' \
  | jq .result.structuredContent

LIVE voter information for a residential address via the Google Civic Information API. Returns the upcoming election, full contest list (federal/state/local/referendum) with candidates including party, websites, phone, email and social channels; polling places; early-vote sites; drop-off locations; and election-administration URLs (registration, mail-ballot info, polling lookup). The most comprehensive per-voter ballot resource. Returns null when Google has no current election for the address (common off-cycle).

Current incumbents for federal offices in a US state. House members keyed by ocd-division/country:us/state:{st}/cd:{N}; senators by virtual ocd-division/country:us/state:{st}/senate:{bioguideId} (Civic doesn't district-key Senate). Governor + statewide officials from hand-curated state-data.ts. State legislators (upper + lower) returned grouped by district as `{districtOcdId, districtNumber, members[]}` so multi-member districts (WV, NH, MD, VT, NJ, MA) preserve all sitting members. Optional ocdIds[] filter to limit to a specific ballot. Source: api.congress.gov + OpenStates v3, refreshed every 7 days.

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"civic.officeholders","arguments":{"state":"WV"}}}' \
  | jq .result.structuredContent

Returns the local election-administration authority for a US state — `tier` is one of county/municipal/township/town/parish/borough/none. Used by UI copy to route to 'your town clerk' vs 'your county clerk' vs 'your parish Registrar of Voters' depending on jurisdiction. Town-only states: ME, NH, VT, RI. Municipal: MA, WI, CT. Township: MI. Parish: LA. Borough: AK. ND has no voter registration at all.

Federal-candidate campaign finance summary for the 2026 cycle (default). Source-of-record: the FEC OpenFEC API. Returns each candidate's name, party, office (H/S/P), state + district, OCD-ID, status (Challenger/Incumbent/Open), and summary financials — total receipts, total disbursements, cash on hand, debts owed, and the coverage end date of the most recent filing. Filter by any of: 2-letter state, OCD division ID (e.g. 'ocd-division/country:us/state:wv/cd:1'), office ('H' / 'S' / 'P'), or cycle. Refreshed daily server-side. Tier-1 confidence; FEC filings are mandatory under FECA.

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"civic.candidate_finance","arguments":{"state":"WV","office":"H"}}}' \
  | jq .result.structuredContent

US Census ACS 5-year demographic profile for a political division, keyed by OCD-ID. Supports state, congressional district, and county geographies (e.g. 'ocd-division/country:us/state:wv', '.../state:wv/cd:2', '.../state:wv/county:kanawha_county'). Returns total population, median age, median household income, race breakdown (white/black/asian/hispanic/other percentages), and percent with bachelor's degree or higher. Optional `vintage` argument (2018-2024) selects a historical ACS 5-year release; defaults to the latest (2023). Tier-1 confidence — Census Bureau is the federal source-of-record for demographic statistics (13 USC § 141, § 193). Cached server-side keyed by (ocdId, vintage); the underlying ACS data only refreshes once per year.

Aggregate operational health snapshot for the public turnout.app data infrastructure. Returns row counts and last-refresh timestamps for every backing dataset: source registry (505 URLs), federal + state-leg officeholders, federal committee assignments, FEC candidate finance (cycle 2026), TIGER/Line divisions (vintage 2024 + 2025), FVAP UOCAVA jurisdictions, NCSL voter rules, Google Civic Information probe coverage, hand-curated ballot measures, Census ACS cache, and the full public tool list. Powers the /status page on turnout.app and any external uptime checker that wants a single GET to assert freshness across the whole stack.

curl -sS https://mcp.turnout.app/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"civic.health","arguments":{}}}' \
  | jq .result.structuredContent

Per-URL freshness for every catalogued source in the turnout.app registry. Returns the most recent verifier sweep result for each URL: status code (200 = ok, 0 = manual or SPA-shell skip, 4xx/5xx = fail), last-ok timestamp, last-checked timestamp, last error sentinel, derived verify mode (http/spa-shell/manual), and the state + task labels stamped by the verifier. Pass `urls[]` for an exact-match lookup of specific URLs, or `stateCode` (2-letter) to filter to one jurisdiction. With no arguments returns the full set (~505 rows). Capped at 1000 rows. Backs the /sources page status pills and any external freshness audit.

Single-bill detail for a federal bill identified by (congress, billType, billNumber). Returns title, plain-text summary (when Congress.gov has published one), sponsor, full cosponsor list (capped at 50 most-recent), latest action, policy area, and the canonical congress.gov URL. Tier-1 confidence — Congress.gov is the federal source-of-record for bill metadata under 2 USC 285b. Cache TTL 24h. Use this to surface 'which of my reps signed onto this bill' by joining cosponsor bioguide IDs to a delegation roster from civic.officeholders. Returns null when the bill doesn't exist on Congress.gov.