io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 4, 2026
Model and map U.S. election races: scenarios, swing, turnout and precinct-level roll-ups.
Local stdio bridge to a hosted U.S. election-modelling service, letting an assistant build race scenarios, apply swings and read tallies, flips, maps and…
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
racemodel is a thin local bridge to the ElectionsMCP hosted MCP server, a modelling service for U.S. election races. Upstream, a user can resolve places and candidates, build a scenario, set candidate shares and turnout assumptions, apply a swing, and then read the race back as tallies, flipped seats, maps, charts and precinct-level roll-ups — including separate handling for primary races.
The bridge holds no election data and computes no
forecast of its own. It serves the upstream server's
tool list locally — exactly as captured from the live
endpoint — and forwards each tool call upstream,
returning the result untouched. Scenario and
simulation state lives upstream, so writes such as
creating a scenario or setting shares are the
service's own modelling operations, forwarded like
every other call. billing_status is a read; there
is no payment, donation or purchase tool in the
surface.
Geography, candidates and contests:
resolve_geography — turn a place name or shorthand
into a canonical geo id (query, required).resolve_candidate — find who holds or runs for a
seat from a person's name (name, required).search_candidates — browse the candidate registry
by filters without supplying a name.lookup_address — resolve an address (address,
required) to its geography.list_contests — list contests for a geography
(geo_id, required).election_calendar — the election calendar. No
required arguments.Scenarios and simulations:
create_scenario — start a new scenario (name,
required).list_scenarios, get_scenario (scenario_id),
commit_version (scenario_id), and diff_versions
(scenario_id, version_a, version_b) — manage
and compare saved scenario versions.set_performance — set shares for a geography in a
scenario (scenario_id, geo_id, shares).target_precincts — precinct targeting for a
scenario (scenario_id, required).set_candidates — set the candidate list for a
simulation (simulation_id, level, candidates).set_turnout — set turnout assumptions
(simulation_id, required).set_race_scope — set a simulation's race scope
(simulation_id, required).list_simulations and get_simulation
(simulation_id, required) — enumerate and read
simulations.share_simulation — share a simulation
(simulation_id, required).Views, swings and roll-ups:
get_view, render_view and set_view — read,
render or set a simulation's view (each takes
simulation_id).render_chart — render a chart (type, required).add_map_comment (simulation_id, body) and
list_map_comments (simulation_id) — annotate and
read back a simulation's map.apply_uniform_swing — apply a uniform swing in
percentage points (simulation_id, level,
swing_pp).apply_swing_to_query — apply a swing scoped by a
query (simulation_id, state, filter).get_tally — the tally at a level (simulation_id,
level).list_flipped — seats that flipped at a level
(simulation_id, level).compare_simulations — compare two simulations at a
level (simulation_id_a, simulation_id_b,
level).roll_up_race — roll a simulation up to the race
level (simulation_id, required).Turnout, returns and reference data:
get_early_voting_turnout — early-voting turnout
for a state (state, required).get_county_voter_turnout_and_registration,
get_state_historical_turnout,
get_live_early_vote_returns and
get_precinct_election_returns — turnout,
registration, historical and returns reads. No
required arguments.get_county_officials and
get_county_economic_and_wealth_profile — county
reference profiles. No required arguments.billing_status and connection_status — account
and connection reads. No required arguments.get_campaign_onboarding, help and get_catalog
— onboarding, help and catalog reads. No required
arguments.Primaries:
list_primary_calendar — primary calendar for a
party (party, required).set_primary_shares — set primary shares
(simulation_id, party).roll_up_primary — roll a primary up
(simulation_id, party).primary_batch_edit — batch-edit a primary
(simulation_id, edits).Meta:
call_tool — invoke another tool by name through
the upstream (name, required).ELECTIONSMCP_MCP_URL (optional) — override the
upstream endpoint. Defaults to
https://www.electionsmcp.com/mcp. (The override
hook is this rebuild's own labelled reconstruction.)ELECTIONSMCP_API_KEY (optional) — when set, its
value is sent on every upstream request under the
header name the registry record pins for this
remote, x-electionsmcp-key. When it is unset, no
auth header is sent. (This forwarding is a labelled
reconstruction; the original capture was keyless.)On the first tool call the client opens a streamable
HTTP session with the upstream: a JSON-RPC
initialize request (protocolVersion 2025-03-26,
clientInfo name racemodel), then a
notifications/initialized notification, then the
tools/call request carrying the caller's arguments
unchanged. When the upstream answers initialize
with an Mcp-Session-Id header, that value rides on
every later request of the session, which is reused
for the life of the process. Replies may arrive as
plain JSON or as server-sent events; both are read.
Successful upstream results pass through verbatim,
including any isError flag the upstream sets.
Failures — a JSON-RPC error, a non-2xx status, an
unreadable response, or a request that cannot be
completed — come back as an isError result whose
text starts with racemodel error: (this rendering
is this rebuild's own labelled reconstruction).
Each tool is also a subcommand taking one JSON argument string (omit it for tools that take none):
Exit codes: 0 on success, 1 on an isError
result, 2 on a usage error.
MCP client config:
The container's default command is mcp, so the first
form is a stdio MCP server; any other arguments reach
the CLI normally.
The test suite runs entirely against a stubbed JSON-RPC upstream — no live network calls.
MIT — see LICENSE.
Source: README.md at commit f2ce3b9
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…
yearqueryrequiredworkspace_scopeWHO 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…
namerequiredcyclelimitpartyofficeworkspace_scopeBROWSE 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:…
qlimitpartyofficeworkspace_scopeResolve 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.…
addressrequiredworkspace_scopeinclude_officialsDiscover 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…
cyclestagegeo_idrequiredworkspace_scopeThe 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…
cyclestateworkspace_scopeSet 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…
levelgeo_idrequiredmarginsharesrequiredturnoutrebalancescenario_idrequiredtotal_votessimulation_idworkspace_scopeexpected_versionReturn 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…
limitfiltergeo_idmarginoffsetcontextgoal_modetarget_pctscenario_idrequiredcandidate_idrolloff_rateworkspace_scopeCreate 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…
namerequiredtagsrace_idcontest_idbaseline_idcampaign_idimport_fromidempotency_keyworkspace_scopeboundary_versionexpected_campaign_revisionRead 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…
viewcyclegrainlevelstateversion_aversion_bversion_idcampaign_id_acampaign_id_bsimulation_idrequiredexpected_hash_a+5 moreA 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…
asofviewgrainlevelsharestatethemetitleformatgeo_idlayersregion+16 moreshare_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,…
asoftyperequiredcyclelevelpartysharestatestylethemetitleclinchformat+17 moreSet 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…
asofrailzoomcyclelevelstagestatelayerssourcecontestmap_grainmap_theme+5 moreA 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…
version_idscenario_idrequiredinclude_stateworkspace_scopeexpected_version_hashSave 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`…
titlesummaryinsight_idsscenario_idrequiredinclude_diffannotation_idsworkspace_scopePage 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…
tagslimitoffsetworkspace_scopeStructured 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…
limitoffsetversion_arequiredversion_brequiredscenario_idrequiredworkspace_scopeRead 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…
staterequiredofficedistrictsource_idcounty_fipsoffice_levelelection_dateelection_typeworkspace_scopeinclude_precinctsRead 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…
sorttierlimitstateoffsetcounty_fipsworkspace_scopeRead 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…
yearlimitstateoffsetworkspace_scopeRead 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…
limitstateoffsetcounty_fipselection_dateworkspace_scopeinclude_precinctsRead 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.
yearlimitpartystateofficeoffsetdistrictcontest_idcounty_fipselection_idoffice_levelelection_date+3 moreRead 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.
qfipslimitpartystateoffsetoffice_levelworkspace_scopeRead 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,…
fipssortlimitstateoffsetworkspace_scopeBILLING — 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,…
workspace_scopeWHO 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…
workspace_scopeReplace 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…
levelrequiredcandidatesrequiredsimulation_idrequiredworkspace_scopeexpected_versionSet 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%…
clearimmiglevelsourcecollegegeo_idshiUnemplowHomecountieshighHomecriterionassumption+5 moreLeave 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…
latlngbodyrequiredleveltitleobjectpayloadregionscategoryicon_typeparent_idfeature_id+10 moreList 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…
campaign_idcomment_idssimulation_idrequiredworkspace_scopeinclude_resolvedApply 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…
as_oflevelrequiredswing_pprequiredsimulation_idrequireddecay_halflifeworkspace_scopedecay_start_datetoward_candidate_idCompute 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…
cyclelevelrequiredchambersimulation_idrequiredworkspace_scopeList 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…
qmodecyclelevellimitowneroffsetrace_idcontest_idupdated_sinceworkspace_scopeRead the canonical simulation/scenario state, including candidates, race scope, geography overrides, active version identity, provenance, and optional summary or selected dot-path fields.
fieldssimulation_idrequiredworkspace_scopeList 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…
grainlevelrequiredlimitstateoffsetsimulation_idrequiredworkspace_scopeCompare 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…
grainlevelrequiredlimitstateformatoffsetversion_aversion_bcampaign_id_acampaign_id_bexpected_hash_aexpected_hash_b+3 moreMint a public, read-only link to the exact canonical scenario/version. Authenticate for durable workspace ownership; revoke_share disables the link.
sectionsttl_dayscampaign_idsimulation_idrequiredinclude_deltasinclude_impactworkspace_scopeRoll 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…
levelregiondistrict_idregion_groupsimulation_idrequiredworkspace_scopeApply 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…
mixmodelevelstaterequiredfilterrequiredsourceweightsswing_ppassumptionmax_precinctssimulation_idrequiredworkspace_scope+2 moreCAMPAIGN 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…
sectionworkspace_scopeOrient 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…
workspace_scopeDISCOVERY — 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…
toollimitquerycursorcategoryworkflowworkspace_scopeexpected_catalog_versionRead 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…
partyrequiredsimulation_idworkspace_scopeSet 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":…
partyrequiredstatesharesstatessimulation_idrequiredinclude_rollupworkspace_scopeThe 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…
asofpartyrequiredstateby_districtsimulation_idrequiredinclude_statesworkspace_scopeATOMIC 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…
editsrequiredforcepartydry_runsimulation_idrequiredsetup_evidenceworkspace_scopecheckpoint_labelexpected_version_hashBind 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.
cyclelevelstageofficerebindcandidatecandidatesgeography_idsimulation_idrequiredworkspace_scopeRun any other tool you are authorized for that is not in this list. Find it and its exact input schema with get_catalog (search, a workflow, or {tool: name}), then call call_tool({ name, arguments }). The named tool…
namerequiredarguments90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
npx @reneturcios/racemodel resolve_geography '{"query":"CA-03"}'npx @reneturcios/racemodel create_scenario '{"name":"Baseline 2026"}'npx @reneturcios/racemodel get_catalognpx @reneturcios/racemodel --versionnpx -y @reneturcios/racemodel mcp{ "mcpServers": { "racemodel": { "command": "npx", "args": ["-y", "@reneturcios/racemodel", "mcp"] } }}docker run -i ghcr.io/cloudcorprecords/racemodeldocker run --rm ghcr.io/cloudcorprecords/racemodel --versionnpm installnpm run buildnpm testnpm run dev