Skip to content
Official MCP RegistryListed

ElectionsMCP

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

First seen 2 Oct 2026. Evidence as of 2 Oct 2026.

151
Tools
From an anonymous probe
1
Source listings
Each with its own history
0
Recorded changes
Since first seen

Tools

ToolDescriptionBehaviour
add_annotationPin a note or highlight on the map — an annotation that travels with the scenario, so collaborators see what the scenario is targeting at a glance. Three types: "pin" (a labeled marker at lng/lat, or anchored to a…Destructive
add_candidateAdd a candidate to the candidates list for a simulation+level. Returns the candidate_id assigned. Pass an optional id (e.g. "boebert") to give the candidate a stable, human-readable id you can reference in later…Destructive
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…Destructive
aggregate_precinctsRoll up the active user-controlled scenario from its canonical precinct and fallback atoms, returning modeled totals plus the scenario's 2024 baseline comparison and provenance. Requires state, nonempty states[],…Read-only
analyze_primary_inflectionsINFLECTION + SENSITIVITY analysis of a modeled presidential primary — under YOUR scenario's assumptions: not just who leads, but when your modeled race clinches and which contests could flip it. Walks roll_up_primary…Read-only
announce_presenceHEARTBEAT — announce that this session (a browser tab or an MCP agent) is live in the workspace, optionally on one scenario. Presence rows power the "who's here" roster: list_presence, plus presence[] on get_view /…Destructive
answer_assumptionSCENARIO TRUST assumptions ledger (tk_960747792b23d3) — record a question you asked the user (or a premise you were given) and the answer that now drives this scenario's modeling: "Does the field consolidate after…Destructive
apply_calendar_scenarioApply a saved calendar scenario BY REFERENCE to a simulation — sets the sim's Democratic calendar to that ordering (reusing the define_dem_calendar path, so the delegate math is untouched). scenario is a saved…Destructive
apply_primary_cohortBULK conditional primary edit — for every precinct in a HOUSE district that matches a 2024 cohort filter, set the candidate shares, in ONE call (instead of one set_primary_precinct_shares per precinct). Scopes to THIS…Destructive
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…Destructive
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…Destructive
billing_statusBILLING — 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,…Read-only
bind_sessionBIND this agent session to the USER'S OPEN /sim — the session-bootstrap contract (tk_2ba54e8466bc19 / tk_7069d33b0c682e). Call this FIRST, before creating or editing anything: pass the page URL the user has open…Destructive
bulk_set_primary_sharesWrite user-authored presidential-primary shares across many retained state or county geographies in one call. Uses the same validation, scenario storage, and delegate-allocation kernel as the single-geography primary…Destructive
candidate_path_explainerPATH-TO-THE-NOMINATION explainer — for each candidate in a presidential-primary scenario (or one candidate_id), a DERIVED, plain-numbers account of HOW they win or WHY they fall short, straight from the delegate…Read-only
candidate_standingPORTAL — one candidate/official's standing across every race you model them in. Give a {name} (and optional {party} to disambiguate); it finds all their appearances across your sims, builds each sim's impact report,…Read-only
check_workspace_consistencySCENARIO TRUST cross-scenario consistency sweep (tk_57e0d6adfac63d) — do this workspace's primary scenarios contradict each other? Groups the COMPARABLE presidential-primary scenarios (same mode+party, same calendar…Read-only
clear_annotationsRemove all annotations from a scenario, or only those of one type when "type" is given.Destructive
clear_dem_calendarDiscard the simulation's user-defined Democratic calendar and revert to the default 2024-based Dem calendar.Destructive
clear_feature_overrideClear the manual percentage override on a single feature (county/state/district), reverting it to its baseline.Destructive
clear_precinct_overrideRemove a precinct-level override from a simulation, reverting that precinct to its 2024 baseline.Destructive
clear_primary_sharesRemove a state's primary vote shares for a party (un-model that contest).Destructive
clear_race_scopeRemove the race scope from a simulation, returning it to national/retrospective mode.Destructive
clone_simulationDuplicate a simulation under a new name. Useful for "save as / variant" workflows. The clone carries the source scenario's overrides, candidates, description, campaign membership AND its annotations…Destructive
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`…Destructive
compare_simulationsCompare 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…Read-only
compute_vote_goalCalculate the deterministic win number and remaining vote gap for the active user-controlled scenario. Supports plurality, majority, or explicit share goals and reconciles from the scenario's geography, turnout, and…Read-only
confirm_connectionCUSTOMER SETUP — confirm a connection challenge THROUGH the MCP pipe: proves this key reaches this account (and workspace, when bound), records the client family, and advances the setup to activate. Typed states:…Destructive
connection_statusWHO 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…Read-only
create_connection_challengeCUSTOMER SETUP — mint a short-lived (15 min), ONE-TIME connection challenge for a setup session you own. Your human tells their AI the code; the AI calls confirm_connection through MCP — that call itself is the…Destructive
create_custom_candidateCreate a workspace-scoped prospective or write-in candidate with a stable identity, party, color, and optional office, then add that identity to canonical general- or primary-model rosters.Destructive
create_raceInstantiate a tenant workspace (a Race) on a real-world Contest. Pass a canonical contest_id ({geo_id}:{office}:{cycle}:{stage}, e.g. "us-nc-cd-04:ushouse:2028:general"). Creates an empty race the caller then adds…Changes data
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…Changes data
create_simulationStart a brand-new what-if model: an empty simulation of any race, ready for candidates, swings, and turnout. Returns simulation_id you can pass to subsequent calls. Pass level to pick the office (president | senate |…Changes data
data_provenanceGOVERNANCE — read the supported 2024 presidential mixed-grain baseline, boundary identities, and user-authored scenario provenance. Pass state:"TX" for the audited 254-county baseline-versus-certified comparison and…Read-only
define_dem_calendarDefine a user-authored Democratic primary calendar order and dates for this simulation. Read list_primary_calendar first for the model's pinned calendar and recorded official schedule evidence. This overrides the model…Destructive
delete_raceDelete one workspace-scoped race. Its standalone scenarios remain available until explicitly deleted.Destructive
delete_reportDelete one generated, workspace-scoped scenario report.Destructive
delete_simulationPermanently delete a simulation.Destructive
describe_open_campaignShow the agent the campaign the user has OPEN right now, as one editable packet. Pass the page URL the user is on (e.g. https://www.electionsmcp.com/sim?sim=sim_xxx&level=house&stage=top_two) OR a raw simulation_id,…Read-only
diff_calendar_scenariosDiff two calendar orderings — each an id/name of a saved calendar scenario, or the literal "default" (the platform calendar). Returns per-contest position moves (earlier/later) and, when you pass a simulation_id +…Read-only
diff_versionsStructured 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…Read-only
election_calendarThe 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…Read-only
exit_primary_candidateRemove a candidate from a party's presidential-primary FIELD and REDISTRIBUTE their modeled vote share to the survivors in one atomic, provenance-carrying edit — the "so-and-so drops out, where do their voters go?"…Destructive
exposureRun a deterministic swing-sensitivity sweep over the active user-controlled scenario and return the modeled control curve, swing-to-flip values, and most sensitive races.Read-only
focus_viewFly the LIVE map camera to a geography — frame the state / county / district / precinct the viewer is watching, so "show them the decisive counties" actually moves the view (tk_9e8de8). Pass a geo to frame: feature_id…Destructive
get_ballot_orderBALLOT DESIGN — read back the ballot order recorded by set_ballot_order for a simulation+level: every roster candidate with its printed ballot position (candidates with a position first, in ballot order, then any…Read-only
get_campaign_contextLoad one campaign geography's state of play: canonical modeled/baseline context and the linked campaign plan, with source and as-of provenance.Read-only
get_campaign_onboardingCAMPAIGN 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…Read-only
get_catalogDISCOVERY — browse workflow/category groups, search tool names and descriptions, or fetch one complete schema and AI guide with tool. No arguments returns a compact counted index of the authorized inventory. Core…Read-only
get_election_datesWhen is the New Hampshire primary? — the REAL, dated election-day rows from the amendable election_dates object (tk_090052d2e6ceda): the primary/caucus date per office and party where known, plus the general election…Read-only
get_geo_knowledgeSTRATEGIC KNOWLEDGE — the documented ruleset + knowledge for a geography, so an AI does not have to KNOW the rules; the platform supplies them. Two tiers MERGED on read: (1) a system-seeded, CITED GLOBAL canonical…Read-only
get_geographyBoundary reference, children, and a demographic summary (county grain — ACS 2023; states and districts return boundary + identity only) for a canonical geo_id (us, us-ca, us-ca-cd-03, us-ca-county-06017,…Read-only
get_impact_reportNation-wide election impact across ALL 6 legislative levels in one call. Cascades county-level (president) overrides to senate/governor state outcomes. Computes state-chamber control where state-leg overrides exist.…Read-only
get_manual_editsEvery manual edit in a scenario — the human's (or an agent's) overrides — in one scenario-scoped read, so a connected AI can see exactly what has been modeled and the deltas it produced. Lists each override grouped by…Read-only
get_plan_catalogCOMMERCIAL CATALOG — the server-owned plan catalog every surface consumes (/pricing, /get-started, account billing, provisioning): six active client types with label, audience, offer (Stripe live price when the store…Read-only
get_provisioning_statusCUSTOMER SETUP — the per-step provisioning state for a setup session you own: queued/running/done/failed with the exact failed step and a safe retry (provision_customer resumes; done steps never repeat). Powers the…Read-only
get_raceOne Race with its contest, scenario list, and latest top-line per scenario.Read-only
get_scenarioA 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…Read-only
get_shapesReturn state, county, district, or precinct boundaries for the active election model, optionally colored by canonical scenario metrics or the validated 2024 presidential baseline. Responses carry stable geography ids,…Read-only
get_simulationRead the canonical simulation/scenario state, including candidates, race scope, geography overrides, active version identity, provenance, and optional summary or selected dot-path fields.Read-only
get_tallyCompute 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…Read-only
get_texas_certified_ballotRead Texas November 2026 candidates and races from the Secretary of State certified general-election ballot and certified write-in supplement. Preserves official names, source pages and dates, candidate IDs, and…Read-only
get_texas_election_referenceRead the versioned 2024 Texas county reference pilot: presidential precinct returns, ballots cast, registered voters and voting methods where supplied. Omit county_fips for available counties and coverage; select a…Read-only
get_usageOBSERVABILITY — session usage meter: total api_calls (every tool invocation since this server session began), distinct tools used, a by_category breakdown, and the per-tool leaderboard. Note: LLM token counts are not…Read-only
get_viewRead 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…Read-only
helpOrient an AI client to campaign onboarding through get_campaign_onboarding, user-controlled election modeling, candidate and presidential-primary workflows, supported geography, scenario versions, contextual War Room…Read-only
list_annotationsList every annotation (pins, highlights, notes) on a scenario.Read-only
list_calendar_scenariosList the named calendar orderings saved in your workspace (save_calendar_scenario), newest first, optionally filtered by party. Requires a verified account.Read-only
list_candidatesList candidates currently configured for a simulation+level. Defaults: a 2024 presidential sim is Harris (D) / Trump (R); every other cycle and down-ballot level defaults to generic Democrat / Republican until you set…Read-only
list_contestsDiscover 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…Read-only
list_custom_candidatesList the workspace's custom (write-in) candidates created via create_custom_candidate — the non-canonical field, distinct from the baked candidate registry. Each carries a stable cust_… id, name, party, and color. Pass…Read-only
list_districtsList every district at a given race level. Returns id, name, state. For House: 435 CDs. For state_senate: ~1900 districts. For state_assembly: ~5400 districts.Read-only
list_eventsWITNESS STREAM (EM-116) — replay the ordered server-side event log of every tool-call (a running then a done event each, carrying category, latency_ms, args_digest, affected{precinct_ids,count}, delta{margin_shift},…Read-only
list_featuresList the geographic features (counties, states, districts, etc.) for a given level. Returns id + name + state.Read-only
list_flippedList 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…Read-only
list_geo_knowledgeList your workspace's CUSTOM geo-knowledge overlays (the rows set_geo_knowledge has written), newest grain first. The global canonical layer is not listed here — read it per-geography with get_geo_knowledge. Requires a…Read-only
list_levelsList the office levels available to a user-controlled scenario, with typed modelability and coverage status for each level.Read-only
list_map_commentsList 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…Read-only
list_map_themesMAP THEMES — the audience-preset registry (tk_bb87df86fdbc28): every theme with its semantic color tokens (party safe/likely/lean steps, tossup, missing, independent, selection, canvas). The SAME registry the live map…Read-only
list_modeled_candidatesPORTFOLIO — every candidate or elected official you are modeling, unioned across ALL of your simulations and every level, deduped by name+party. One call returns the roster behind the candidate portals: each entry…Read-only
list_precinct_overridesList every precinct override stored in a simulation. Useful for AI clients to inspect what state they've already mutated.Read-only
list_presenceWHO IS LIVE in this workspace right now — every browser tab and MCP agent with a presence heartbeat in the last ~45s, one row per actor: {actor, name, color, scenario_id (the sim they have open / are bound to), level,…Read-only
list_primary_calendarRead the 2028 primary calendar with source dates, schedule certainty, modeled delegate coverage, missing jurisdictions, and threshold basis. New calendars include the six DNC-approved early dates; other unverified…Read-only
list_racesList the Races (contest workspaces) in this workspace, with scenario counts.Read-only
list_scenario_versionsThe append-only version chain for a scenario, newest last, with per-version summary + top_line. The record of how the read on the contest evolved.Read-only
list_scenariosPage 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…Read-only
list_siblingsList scenario branches that share a common parent so user-authored alternatives remain navigable and comparable.Read-only
list_simulationsList 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…Read-only
list_threadsThe War Room as ONE campaign-scoped feed of THREADS — full discussion context in a single call. Pass campaign_id inside a campaign; omit it for scenario-global discussion only. Every content object is a thread: the…Read-only
list_workspace_commentsList contextual War Room discussion across the active workspace, optionally limited to one campaign. Deep links preserve the exact campaign, scenario, geography, and selected-map context.Read-only
lookup_addressResolve 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.…Read-only
manage_billingBILLING — returns {portal_url} to the Stripe Customer Portal, where the USER can update payment, switch plan, or cancel (opened in a browser). Requires a verified account that already has a subscription.Destructive
optimize_calendarRANK primary-calendar orderings for a candidate against the sim's modeled per-state delegate hauls — which calendar order best helps candidate X. DETERMINISTIC and EXPLAINED, with NO invented probabilities: the total…Read-only
precincts_in_districtPage precincts whose centroid falls inside the district boundary, in precinct-id order. Returns at most 100 rows plus total_precincts, returned, has_more and next_offset. Repeat with next_offset and unchanged filters…Read-only
primary_batch_editATOMIC batch-edit transaction for a PRIMARY scenario — validate, preview, apply, and roll back a whole SET of candidate / share / calendar edits as ONE transaction. Pass edits:[{op, ...}, …] where each entry carries…Destructive
primary_narrativeDATA-ONLY narrative package for a presidential-primary scenario — the STORY of the race as structured data an AI client turns into its own storyboard, press piece, memo, or social thread (electionsmcp returns the…Read-only
primary_state_effectiveONE STATE's primary exactly as the delegate count sees it — the per-state READ view of roll_up_primary. When a state is modeled at COUNTY or PRECINCT grain, the statewide sliders no longer set its number: the state's…Read-only
provision_customerCUSTOMER SETUP — run (or RESUME) the checkpointed provisioning saga for a setup session you own: exactly one workspace with its client type, owner membership, roster record and the exact versioned map binding; returns…Destructive
react_map_commentToggle an emoji reaction on a War Room chat message (map comment): adds the caller to reactions[emoji] if absent, removes them if present. reactions = { "<emoji>": ["<email/agent>", …] }. Live (~1s).Destructive
remove_annotationRemove a single annotation by its id.Destructive
remove_candidateRemove one candidate from a simulation+level roster (and drop them from any feature overrides). Cannot remove the last candidate.Destructive
remove_map_commentDelete a map comment by id (soft-delete, so threads stay intact). Only the comment's author can delete it.Destructive
rename_simulationRename a simulation/scenario — give the map a real title instead of the stuck default. Sets the name and appends a metadata version to the audit chain. Accepts simulation_id or scenario_id (same thing). A focused alias…Destructive
render_chartshare_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,…Read-only
render_viewA 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…Read-only
reset_overridesClear all manual overrides — the "reset to baseline" action. Pass level to reset just that level; omit to reset every level. include_precincts (default true) also clears precinct overrides.Destructive
resolve_candidateWHO 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…Read-only
resolve_geographyTurn 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…Read-only
resolve_identityRead a reviewed public candidate identity and its exact registry, ballot and election-result aliases, per-race parties and linked evidence. source_id resolves an exact ID; name matches a complete reviewed name (case…Read-only
resolve_map_commentMark a map comment resolved (closed), like resolving a Google-Docs comment — or reopen it with resolved:false. Records who resolved it.Destructive
restore_versionSet the scenario's working state back to a prior version's payload, and return that complete per-precinct `state` (so the map redraws to the exact configuration) plus the hash chain. Append-only: this records a NEW…Destructive
resume_setupCUSTOMER SETUP — the authoritative state of a setup session after auth, checkout or reload: status, step, client type, setup_scope, geography, owner linkage. A signed-in caller claims an unowned session…Destructive
revision_ladderRevision ladder L2 as DATA (not a render): render-ready before/after delta so the CLIENT visualizes it. Two modes — VERSION: {scenario_id, version_a, version_b} returns per-geo/candidate/level rows (before, after,…Read-only
revoke_shareRevoke a previously-minted public share token. The /share/<token> URL stops resolving.Destructive
roll_up_primaryThe running delegate count — OR, for a race-scoped downballot sim, that race's own share rollup. DOWNBALLOT (tk_2110d54c1d0871): when the scenario is race-scoped to a non-presidential office (set_race_scope…Read-only
roll_up_raceRoll 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…Read-only
roll_up_state_racesRoll up every user-modeled race at one office level within a state, returning current modeled winners and margins from the canonical scenarios.Read-only
save_calendar_scenarioSave a NAMED primary-calendar ordering as a first-class, diffable artifact. The 2028 Democratic calendar order is undetermined, so the ordering is itself a strategic choice: it does not change any candidate's TOTAL…Destructive
scenario_handoff_bundleOne consolidated, machine-readable audit + handoff packet for a scenario, so a teammate or a future AI session can resume without reconstructing context from many calls. AGGREGATES existing read tools into one payload:…Read-only
search_candidatesBROWSE 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:…Read-only
senate_controlCompute Senate control for a cycle using the real class calendar. Only one class (~33 seats) is on the ballot per cycle — the rest carry over at their current party. Pass the simulation_id + cycle: the up-this-cycle…Read-only
senate_path_to_majorityCalculate a deterministic Senate path to majority from the active user-controlled scenario's modeled margins, carryover assumptions, protected seats, and target control rule.Read-only
set_ballot_orderBALLOT DESIGN — record each candidate's printed ballot POSITION (and an optional per-candidate confusion/roll-off assumption) for a simulation+level roster, so same-name and crowded races can be disambiguated. This is…Destructive
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…Destructive
set_compare_pathsGenerate a two-path comparison that the browser renders side-by-side. Stores two named delegate PATHS (per-state candidate allocations) on the sim as Path A and Path B; when the user opens the sim in the simulator, the…Destructive
set_cycleSet the election cycle modeled by the active scenario. This updates the canonical scenario and any open application view bound to it.Destructive
set_feature_percentagesOverride the vote percentages on a single feature. Percentages keyed by candidate_id. Residual = "Other".Destructive
set_geo_knowledgeWrite your workspace CUSTOM overlay for a geography — campaign-specific notes, target shares, turf intel, local relationships, assumptions — layered ON TOP of (and able to override) the global canonical layer read by…Destructive
set_modeSet presidential modeling mode to general, 2028 Democratic primary, or 2028 Republican primary. Existing candidate rosters and user changes are preserved; use set_primary_candidates to define the prospective field…Destructive
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…Destructive
set_precinct_pctsSet a precinct-level override in a simulation. Pass the candidate-id → pct map (e.g. {D: 52.5, R: 46.0}). Overrides the modeled result for this precinct, which then rolls up into every race the precinct is part of…Destructive
set_primary_asofMove the calendar playhead — the point in the primary calendar "as of" which to view the race on the map/chart. Pass an integer (number of contests counted, 0 = before the first contest) or null for the full calendar —…Destructive
set_primary_candidatesDefine the candidate field for a party's presidential primary on this simulation (the GOP/Dem contenders). Persisted on the sim so the browser and AI share one roster. Shares set via set_primary_shares reference these…Destructive
set_primary_county_sharesModel a party's presidential primary at COUNTY level: set one county's candidate vote shares within a state's primary. The state's effective share is the TURNOUT-WEIGHTED aggregate of its modeled counties (weighted by…Destructive
set_primary_demo_leversSet a candidate's GLOBAL DEMOGRAPHIC DIALS in a primary — how many points to shift them among a voter group across the whole district/state. levers = { uniform, college, immig, highHome, lowHome, hiUnemp } in…Destructive
set_primary_grain_prefPin which modeling grain DRIVES a state in a party's presidential primary — i.e. which level feeds that state's delegate allocation. "auto" (default) = the finest grain modeled wins (precinct > county > the flat…Destructive
set_primary_precinct_sharesModel a party's presidential primary at PRECINCT level — the finest grain. Set one precinct's candidate vote shares; the state's effective share becomes the TURNOUT-WEIGHTED aggregate of its modeled precincts (each…Destructive
set_primary_sharesSet a party's presidential-primary vote shares — one state, or MANY states in a single call. SINGLE STATE: pass `state` + `shares` (unchanged behavior; echoes the full running roll_up). BATCH: pass `states` = { "SC":…Destructive
set_race_scopeBind the canonical scenario to one race/campaign so its map, tally, candidates, War Room context, operations, outputs, and MCP actions share the same race identity.Destructive
set_swingsPersist the swing-slider state so a scenario built by hand in the browser (uniform + demographic share swings, the swing target, and the demographic region scope) survives reload. Opaque blob, mirrored to/from the UI.Destructive
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%…Destructive
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…Destructive
share_simulationMint a public, read-only link to the exact canonical scenario/version. Authenticate for durable workspace ownership; revoke_share disables the link.Destructive
start_setupCUSTOMER SETUP — create a durable server-side setup session from an acquisition choice: client_type (team size/use) plus setup_scope (race|county|district|state|multi), optional geography (state/county_fips/party), and…Destructive
start_subscriptionBILLING — begin a paid subscription. Returns {checkout_url}: a Stripe-hosted Checkout page the USER opens in a browser to enter payment — no card details are ever handled by this server or the agent. Requires a…Destructive
target_listCAMPAIGN OPERATIONS — read or reorder the active scenario's shared War Room target posts. Targets keep their stable post ids, rank, text, and selected region context.Destructive
target_precinctsReturn 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…Read-only
tipping_pointIdentify the tipping-point race and nearby high-leverage races in the active user-controlled scenario, using its modeled margins and canonical version context.Read-only
update_scenarioEdit a Scenario's name / description / tags. Appends a metadata version to the chain.Destructive
verify_auditWITNESS AUDIT (EM-116) — re-verify the immutable, content-hashed audit chain of a scenario's committed versions (commit_version is the append-only hash-stamped write). Recomputes each version's hash from its stored…Read-only

Change history

No changes since the first observation. The first snapshot is the baseline.

Source listings
SourceListingFirst seenLast seenVersions
Official MCP Registrycom.electionsmcp/electionsmcp2 Oct 20262 Oct 20261