com.electionsmcp/electionsmcp

Tools

• add_annotation

  Pin 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…

  shallow
• add_candidate

  Add 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…

  shallow
• add_map_comment

  Leave 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…

  shallow
• aggregate_precincts

  Roll 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[],…

  shallow
• analyze_primary_inflections

  INFLECTION + 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…

  shallow
• announce_presence

  HEARTBEAT — 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 /…

  shallow
• answer_assumption

  SCENARIO 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…

  shallow
• apply_calendar_scenario

  Apply 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…

  shallow
• apply_primary_cohort

  BULK 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…

  shallow
• apply_swing_to_query

  Apply 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…

  shallow
• apply_uniform_swing

  Apply 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…

  shallow
• billing_status

  BILLING — 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,…

  shallow
• bind_session

  BIND 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…

  shallow
• bulk_set_primary_shares

  Write 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…

  shallow
• candidate_path_explainer

  PATH-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…

  shallow
• candidate_standing

  PORTAL — 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,…

  shallow
• check_workspace_consistency

  SCENARIO 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…

  shallow
• clear_annotations

  Remove all annotations from a scenario, or only those of one type when "type" is given.

  shallow
• clear_dem_calendar

  Discard the simulation's user-defined Democratic calendar and revert to the default 2024-based Dem calendar.

  shallow
• clear_feature_override

  Clear the manual percentage override on a single feature (county/state/district), reverting it to its baseline.

  shallow
• clear_precinct_override

  Remove a precinct-level override from a simulation, reverting that precinct to its 2024 baseline.

  shallow
• clear_primary_shares

  Remove a state's primary vote shares for a party (un-model that contest).

  shallow
• clear_race_scope

  Remove the race scope from a simulation, returning it to national/retrospective mode.

  shallow
• clone_simulation

  Duplicate 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…

  shallow
• commit_version

  Save 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`…

  shallow
• compare_simulations

  Compare 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…

  shallow
• compute_vote_goal

  Calculate 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…

  shallow
• confirm_connection

  CUSTOMER 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:…

  shallow
• connection_status

  WHO 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…

  shallow
• create_connection_challenge

  CUSTOMER 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…

  shallow
• create_custom_candidate

  Create 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.

  shallow
• create_race

  Instantiate 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…

  shallow
• create_scenario

  Create 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…

  shallow
• create_simulation

  Start 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 |…

  shallow
• data_provenance

  GOVERNANCE — 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…

  shallow
• define_dem_calendar

  Define 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…

  shallow
• delete_race

  Delete one workspace-scoped race. Its standalone scenarios remain available until explicitly deleted.

  shallow
• delete_report

  Delete one generated, workspace-scoped scenario report.

  shallow
• delete_simulation

  Permanently delete a simulation.

  shallow
• describe_open_campaign

  Show 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,…

  shallow
• diff_calendar_scenarios

  Diff 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 +…

  shallow
• diff_versions

  Structured 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…

  shallow
• election_calendar

  The 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…

  shallow
• exit_primary_candidate

  Remove 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?"…

  shallow
• exposure

  Run 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.

  shallow
• focus_view

  Fly 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…

  shallow
• get_ballot_order

  BALLOT 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…

  shallow
• get_campaign_context

  Load one campaign geography's state of play: canonical modeled/baseline context and the linked campaign plan, with source and as-of provenance.

  shallow
• get_campaign_onboarding

  CAMPAIGN 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…

  shallow
• get_catalog

  DISCOVERY — 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…

  shallow
• get_election_dates

  When 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…

  shallow
• get_geo_knowledge

  STRATEGIC 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…

  shallow
• get_geography

  Boundary 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,…

  shallow
• get_impact_report

  Nation-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.…

  shallow
• get_manual_edits

  Every 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…

  shallow
• get_plan_catalog

  COMMERCIAL 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…

  shallow
• get_provisioning_status

  CUSTOMER 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…

  shallow
• get_race

  One Race with its contest, scenario list, and latest top-line per scenario.

  shallow
• get_scenario

  A 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…

  shallow
• get_shapes

  Return 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,…

  shallow
• get_simulation

  Read the canonical simulation/scenario state, including candidates, race scope, geography overrides, active version identity, provenance, and optional summary or selected dot-path fields.

  shallow
• get_tally

  Compute 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…

  shallow
• get_texas_certified_ballot

  Read 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…

  shallow
• get_texas_election_reference

  Read 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…

  shallow
• get_usage

  OBSERVABILITY — 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…

  shallow
• get_view

  Read 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…

  shallow
• help

  Orient 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…

  shallow
• list_annotations

  List every annotation (pins, highlights, notes) on a scenario.

  shallow
• list_calendar_scenarios

  List the named calendar orderings saved in your workspace (save_calendar_scenario), newest first, optionally filtered by party. Requires a verified account.

  shallow
• list_candidates

  List 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…

  shallow
• list_contests

  Discover 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…

  shallow
• list_custom_candidates

  List 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…

  shallow
• list_districts

  List 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.

  shallow
• list_events

  WITNESS 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},…

  shallow
• list_features

  List the geographic features (counties, states, districts, etc.) for a given level. Returns id + name + state.

  shallow
• list_flipped

  List 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…

  shallow
• list_geo_knowledge

  List 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…

  shallow
• list_levels

  List the office levels available to a user-controlled scenario, with typed modelability and coverage status for each level.

  shallow
• list_map_comments

  List 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…

  shallow
• list_map_themes

  MAP 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…

  shallow
• list_modeled_candidates

  PORTFOLIO — 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…

  shallow
• list_precinct_overrides

  List every precinct override stored in a simulation. Useful for AI clients to inspect what state they've already mutated.

  shallow
• list_presence

  WHO 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,…

  shallow
• list_primary_calendar

  Read 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…

  shallow
• list_races

  List the Races (contest workspaces) in this workspace, with scenario counts.

  shallow
• list_scenario_versions

  The 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.

  shallow
• list_scenarios

  Page 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…

  shallow
• list_siblings

  List scenario branches that share a common parent so user-authored alternatives remain navigable and comparable.

  shallow
• list_simulations

  List 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…

  shallow
• list_threads

  The 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…

  shallow
• list_workspace_comments

  List 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.

  shallow
• lookup_address

  Resolve 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.…

  shallow
• manage_billing

  BILLING — 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.

  shallow
• optimize_calendar

  RANK 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…

  shallow
• precincts_in_district

  Page 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…

  shallow
• primary_batch_edit

  ATOMIC 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…

  shallow
• primary_narrative

  DATA-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…

  shallow
• primary_state_effective

  ONE 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…

  shallow
• provision_customer

  CUSTOMER 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…

  shallow
• react_map_comment

  Toggle 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).

  shallow
• remove_annotation

  Remove a single annotation by its id.

  shallow
• remove_candidate

  Remove one candidate from a simulation+level roster (and drop them from any feature overrides). Cannot remove the last candidate.

  shallow
• remove_map_comment

  Delete a map comment by id (soft-delete, so threads stay intact). Only the comment's author can delete it.

  shallow
• rename_simulation

  Rename 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…

  shallow
• render_chart

  share_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,…

  shallow
• render_view

  A 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…

  shallow
• reset_overrides

  Clear 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.

  shallow
• resolve_candidate

  WHO 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…

  shallow
• resolve_geography

  Turn 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…

  shallow
• resolve_identity

  Read 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…

  shallow
• resolve_map_comment

  Mark a map comment resolved (closed), like resolving a Google-Docs comment — or reopen it with resolved:false. Records who resolved it.

  shallow
• restore_version

  Set 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…

  shallow
• resume_setup

  CUSTOMER 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…

  shallow
• revision_ladder

  Revision 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,…

  shallow
• revoke_share

  Revoke a previously-minted public share token. The /share/<token> URL stops resolving.

  shallow
• roll_up_primary

  The 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…

  shallow
• roll_up_race

  Roll 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…

  shallow
• roll_up_state_races

  Roll up every user-modeled race at one office level within a state, returning current modeled winners and margins from the canonical scenarios.

  shallow
• save_calendar_scenario

  Save 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…

  shallow
• scenario_handoff_bundle

  One 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:…

  shallow
• search_candidates

  BROWSE 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:…

  shallow
• senate_control

  Compute 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…

  shallow
• senate_path_to_majority

  Calculate a deterministic Senate path to majority from the active user-controlled scenario's modeled margins, carryover assumptions, protected seats, and target control rule.

  shallow
• set_ballot_order

  BALLOT 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…

  shallow
• set_candidates

  Replace 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…

  shallow
• set_compare_paths

  Generate 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…

  shallow
• set_cycle

  Set the election cycle modeled by the active scenario. This updates the canonical scenario and any open application view bound to it.

  shallow
• set_feature_percentages

  Override the vote percentages on a single feature. Percentages keyed by candidate_id. Residual = "Other".

  shallow
• set_geo_knowledge

  Write 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…

  shallow
• set_mode

  Set 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…

  shallow
• set_performance

  Set 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…

  shallow
• set_precinct_pcts

  Set 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…

  shallow
• set_primary_asof

  Move 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 —…

  shallow
• set_primary_candidates

  Define 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…

  shallow
• set_primary_county_shares

  Model 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…

  shallow
• set_primary_demo_levers

  Set 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…

  shallow
• set_primary_grain_pref

  Pin 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…

  shallow
• set_primary_precinct_shares

  Model 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…

  shallow
• set_primary_shares

  Set 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":…

  shallow
• set_race_scope

  Bind 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.

  shallow
• set_swings

  Persist 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.

  shallow
• set_turnout

  Set 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%…

  shallow
• set_view

  Set 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…

  shallow
• share_simulation

  Mint a public, read-only link to the exact canonical scenario/version. Authenticate for durable workspace ownership; revoke_share disables the link.

  shallow
• start_setup

  CUSTOMER 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…

  shallow
• start_subscription

  BILLING — 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…

  shallow
• target_list

  CAMPAIGN 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.

  shallow
• target_precincts

  Return 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…

  shallow
• tipping_point

  Identify the tipping-point race and nearby high-leverage races in the active user-controlled scenario, using its modeled margins and canonical version context.

  shallow
• update_scenario

  Edit a Scenario's name / description / tags. Appends a metadata version to the chain.

  shallow
• verify_audit

  WITNESS 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…

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/67475fec-9f20-4642-8b57-52515fd4403e/badge.svg)](https://vouch.tools/servers/67475fec-9f20-4642-8b57-52515fd4403e)