Agents Index

ElectionsMCP

Online

Model and map any 2028 U.S. race down to the precinct: scenarios, swing, turnout, and roll-ups.

Visit publisherConnectJSON

What it can do: 48 tools

  • resolve_geography read-onlyTurn a place name or shorthand into its canonical geo_id — resolve natural-language or structured location input. Handles "CA-03"/"NC-4" (congressional districts), bare state names/abbreviations, "<County> County…
  • resolve_candidate read-onlyWHO holds or runs for WHAT — turn a candidate/officeholder name into their seat + next race. Given a name (full, last-name, or a registry alias — "Lauren Boebert", "Boebert"), returns the person(s) who match with their…
  • search_candidates read-onlyBROWSE the canonical candidate registry WITHOUT a name — the nameless companion to resolve_candidate (which requires a name). Filter the registry of canonical people by party, office, and/or a name substring:…
  • lookup_address read-onlyResolve a US street address, ZIP, state, or U.S. House district and show workspace campaigns covering the result. Street addresses return a geocoded point and containing districts, with a precinct when coverage exists.…
  • list_contests read-onlyDiscover contests for a geography and election cycle. Filter general, primary (dem_primary/rep_primary), or all stages; count describes the returned top-level rows. National presidential primaries are discoverable in…
  • election_calendar read-onlyThe election planning calendar. National form ({cycle}) returns federal contests, governors and by_state office lists; state form ({state,cycle}) returns a four-year horizon. Other statewide executive offices use the…
  • set_performanceSet a candidate's vote share, such as the Democratic candidate to 54%, in one specific county, district, state, or precinct (the general-election override). Routes a county/state/district geo_id to a feature override…
  • target_precincts read-onlyReturn structured precinct model rows: precinct_id, name, county, county_fips, baseline_share, modeled_share, ballots_est, overridden, and gap_to_goal. The response does not include demographic columns or demographic…
  • create_scenarioCreate a new Scenario (a modeled path) — optionally inside a Race and seeded from a contest_id or an existing scenario (import_from). Seeds an immutable baseline version (v1). Returns scenario_id + version_id. (A…
  • get_view read-onlyRead the exact map/view state the application renders for a canonical scenario: headline totals, selected geography, modeled feature colors, annotations, primary-calendar playhead, candidate roster, presence, and a…
  • render_view read-onlyA headless server-rendered IMAGE of the map — the rendered view a viewer sees, as SVG or PNG, WITHOUT a browser (tk_0b6d3501 P2). For a scenario + level (president | senate | house | governor | the execs) it draws the…
  • render_chart read-onlyshare_comparison compares candidate shares for two saved versions of one model or two same-contest statewide general-election models. Returns canonical integer candidate votes, all-ballot shares, D-minus-R margins,…
  • set_viewSet the active scenario view and selected map context: race stage, calendar playhead, geography grain, result source, selected feature, camera, map theme, and rail. The same persisted view state and deep link are used…
  • get_scenario read-onlyA Scenario at its latest version (or a specified version_id): metadata (incl. latest_hash) + the version's top_line (margin / EC / viability) + its content hash/prev_hash. EM-119: pass a version_id (or…
  • commit_versionSave the scenario's current state as a new immutable, hash-stamped version in the append-only chain. Records a diff vs the parent version and the recomputed top_line, and returns a content `hash` (+ `prev_hash`…
  • list_scenarios read-onlyPage saved scenarios/simulations in this workspace by updated_at descending and scenario_id ascending, without version blobs. Returns scenario_id, name, level, cycle, contest_id, race_id, tags, durable_id, published…
  • diff_versions read-onlyStructured diff between two immutable versions. Raw before/after remain stored override patches (null means no saved override). Precinct cells also include effective_before/effective_after shares with their…
  • get_early_voting_turnout read-onlyRead early voting, absentee/mail, election-day, and provisional vote-method breakdowns alongside registered-voter, ballots-cast, and undervote/overvote turnout statistics by race and candidate from RoutPoint v2…
  • get_county_voter_turnout_and_registration read-onlyRead county voter registration, party registration (DEM/REP/UNA/Other), voting-age population, 2024/2022/2020/2026 ballots cast and turnout percentages, 2020-to-2024 partisan swing, and competitiveness tiers across…
  • get_state_historical_turnout read-onlyRead 50-year statewide prior-cycle turnout and vote totals (1976 through 2026 across all 50 states and DC): ballots cast, registered voters, voting-age population, turnout percentage, DEM/REP vote shares, margin, and…
  • get_live_early_vote_returns read-onlyRead live 2026-11-03 General Election pre-election mail ballot requests, mail ballots returned, early in-person ballots, and ballot composition by voter registration party (DEM/REP/UNA/Other) from continuously…
  • get_precinct_election_returns read-onlyRead precinct-level election returns and normalized early-voting, absentee/mail, election-day, and provisional breakdowns across 87.7M precinct rows (linked to mapsmcp_precinct_id) from RoutPoint v2.
  • get_county_officials read-onlyRead current local, county, municipal, judicial, and school-board officials (40,431 local officials; 97,231 total officials) by 5-digit county FIPS or state from RoutPoint v2.
  • get_county_economic_and_wealth_profile read-onlyRead a county’s economic vitality dossier (Census 15-sector business patterns, establishments, employees, payroll, average annual wage, new SOS LLC/Corp formations, SEC Form D capital raises, Form 4/FEC major donors,…
  • billing_status read-onlyBILLING — your subscription state: {billing_enabled, logged_in, plan (personal|team|null), status, active, renews, can_save}. billing_enabled is false until the server is configured with Stripe; while it is false,…
  • connection_status read-onlyWHO AM I — how THIS session is authenticated and which workspace this request resolved to. Returns authentication fields plus workspace {workspace_id, role, selection_source}. Modern MCP clients select a workspace with…
  • set_candidatesReplace the entire candidate roster for a simulation+level in one call (add / edit / remove / reorder). Each candidate: {id?, name, party, color?, incumbent?}; ids auto-assigned if omitted. Use this to set the real…
  • set_turnoutSet the turnout (mobilization) model. PRESIDENT (default, unchanged): each dial is a percentage-point boost toward toward_candidate_id in counties over an ACS threshold (college = >20% BA share, immig = >15%…
  • add_map_commentLeave a Google-Docs-style COMMENT on the scenario map — a threaded, resolvable discussion anchored to a place. CAMPAIGN ISOLATION: when working inside a campaign, pass campaign_id; the scenario must be filed under it…
  • list_map_comments read-onlyList one campaign's map comments on a scenario (oldest-first), each with its campaign_id, anchor, author, body, @mentions, parent_id, and resolved state. Pass campaign_id inside a campaign; only that exact campaign is…
  • apply_uniform_swingApply an incremental swing in points toward one candidate at the requested office. A saved race_scope restricts writes to that state or district and refuses a different office or unresolved geography. Unscoped and…
  • get_tally read-onlyCompute the current per-candidate tally for a simulation+level. For President: state-aggregated EVs. For others: feature counts. For level:"senate" the default is the 50-state per-candidate race scoreboard; pass…
  • list_simulations read-onlyList saved simulations in this workspace (id, name, level, cycle, mode, contest_id, last-modified; rows stamped with an identity also carry created_by/updated_by member user_ids). Optional filters narrow a large…
  • get_simulation read-onlyRead the canonical simulation/scenario state, including candidates, race scope, geography overrides, active version identity, provenance, and optional summary or selected dot-path fields.
  • list_flipped read-onlyList baseline-to-model winner changes. Defaults to state for statewide offices, county for president, and district for house/state legislature. Explicit grain:county|precinct uses canonical integer local votes for a…
  • compare_simulations read-onlyCompare two simulations. Without grain, returns the existing chamber/feature comparison. With grain:county|precinct and one state, compares exact saved canonical vote rows: margin(B)-margin(A), winners, flips, ballots…
  • share_simulationMint a public, read-only link to the exact canonical scenario/version. Authenticate for durable workspace ownership; revoke_share disables the link.
  • roll_up_race read-onlyRoll up precincts to a race outcome under the current simulation. Sums baseline votes for all precincts inside the district boundary, applying overrides in precedence order: a per-precinct override wins, else…
  • apply_swing_to_queryApply a uniform swing or an explicit per-precinct weights vector to a filtered cohort in one atomic call. Weights select only their named IDs, support canonical statewide mechanisms, and optionally rescale a persuasion…
  • get_campaign_onboarding read-onlyCAMPAIGN ONBOARDING — guide a campaign manager or joining staff member through setup in their connected AI. Read one step or the complete guide: connection, campaign identity, team access, optional data imports, first…

…and 8 more.

Connect it

Claude Code
claude mcp add --transport http electionsmcp https://www.electionsmcp.com/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://www.electionsmcp.com/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "electionsmcp": {
      "url": "https://www.electionsmcp.com/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "electionsmcp": {
      "type": "http",
      "url": "https://www.electionsmcp.com/mcp"
    }
  }
}

Questions

What does ElectionsMCP do?

Model and map any 2028 U.S. race down to the precinct: scenarios, swing, turnout, and roll-ups. It exposes 48 tools to AI assistants.

What tools does ElectionsMCP provide?

48 tools, including resolve_geography, resolve_candidate, search_candidates, lookup_address, list_contests, election_calendar, set_performance, target_precincts, create_scenario, get_view, render_view, render_chart….

How do I connect ElectionsMCP to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://www.electionsmcp.com/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does ElectionsMCP require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is ElectionsMCP online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes ElectionsMCP?

electionsmcp.com. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Travel, Maps & Places