ElectionsMCP

com.electionsmcp由 electionsmcp.com 發布官方發布者v0.2.0更新於 Oct 24, 2026

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

已驗證Streamable HTTP可網頁執行位置與生活資料與分析

概覽

AI 產生的概覽

讓助理模擬並地圖化 2028 年美國選舉,逐級細到 precinct 的情境、搖擺與投票率分析。

可以做什麼
提供美國選舉模擬與地圖工具:可解析地名、候選人與地址,列出選區與選舉行事曆,並建立情境、設定候選人得票率、套用搖擺與投票率模型,再取得各級彙總、翻盤清單與版本差異。另有渲染地圖與圖表、產生唯讀分享連結、地圖留言,以及查詢各州歷史投票率、提前投票與郡級經濟資料的工具。
適用情境
適合政治分析、競選規劃或選舉報導工作者,想在對話中模擬 2028 年聯邦與州級選戰、測試搖擺與投票率假設,或查詢選民登記與投票率歷史資料時使用。
執行需求
遠端 HTTP 端點,無需本機執行環境。API 金鑰為選用,透過 x-electionsmcp-key 標頭提供;未提供時僅能使用免費的讀取與模擬沙盒,提供後模擬可存入持久層。金鑰需在官網登入取得。
安裝前請注意
金鑰以 x-electionsmcp-key 標頭傳送,請妥善保管。工具會建立與修改情境、版本、候選人名單與地圖留言,並可產生公開唯讀分享連結;分享前請確認內容。另有訂閱與計費狀態工具,使用前應了解方案與儲存限制。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 ElectionsMCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.electionsmcp%2Felectionsmcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "electionsmcp": {
      "type": "http",
      "url": "https://www.electionsmcp.com/mcp"
    }
  }
}

工具

48

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…

輸入參數yearquery必填workspace_scope

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…

輸入參數name必填cyclelimitpartyofficeworkspace_scope

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

輸入參數qlimitpartyofficeworkspace_scope

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

輸入參數address必填workspace_scopeinclude_officials

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…

輸入參數cyclestagegeo_id必填workspace_scope

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…

輸入參數cyclestateworkspace_scope

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…

輸入參數levelgeo_id必填marginshares必填turnoutrebalancescenario_id必填total_votessimulation_idworkspace_scopeexpected_version

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…

輸入參數limitfiltergeo_idmarginoffsetcontextgoal_modetarget_pctscenario_id必填candidate_idrolloff_rateworkspace_scope

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…

輸入參數name必填tagsrace_idcontest_idbaseline_idcampaign_idimport_fromidempotency_keyworkspace_scopeboundary_versionexpected_campaign_revision

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…

輸入參數viewcyclegrainlevelstateversion_aversion_bversion_idcampaign_id_acampaign_id_bsimulation_id必填expected_hash_a另有 5 個

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…

輸入參數asofviewgrainlevelsharestatethemetitleformatgeo_idlayersregion另有 16 個

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

輸入參數asoftype必填cyclelevelpartysharestatestylethemetitleclinchformat另有 17 個

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…

輸入參數asofrailzoomcyclelevelstagestatelayerssourcecontestmap_grainmap_theme另有 5 個

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…

輸入參數version_idscenario_id必填include_stateworkspace_scopeexpected_version_hash

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

輸入參數titlesummaryinsight_idsscenario_id必填include_diffannotation_idsworkspace_scope

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…

輸入參數tagslimitoffsetworkspace_scope

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…

輸入參數limitoffsetversion_a必填version_b必填scenario_id必填workspace_scope

get_early_voting_turnout

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

輸入參數state必填officedistrictsource_idcounty_fipsoffice_levelelection_dateelection_typeworkspace_scopeinclude_precincts

get_county_voter_turnout_and_registration

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

輸入參數sorttierlimitstateoffsetcounty_fipsworkspace_scope

get_state_historical_turnout

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

get_live_early_vote_returns

Read live 2026-11-03 General Election pre-election mail ballot requests, mail ballots returned, early in-person ballots, and partisan ballot composition (DEM vs. REP vs. UNA/Other) compared against each county’s 2024…

輸入參數limitstateoffsetcounty_fipselection_dateworkspace_scope

get_precinct_election_returns

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

get_county_officials

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

get_county_economic_and_wealth_profile

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

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

輸入參數workspace_scope

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…

輸入參數workspace_scope

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…

輸入參數level必填candidates必填simulation_id必填workspace_scopeexpected_version

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

輸入參數clearimmiglevelsourcecollegegeo_idshiUnemplowHomecountieshighHomecriterionassumption另有 5 個

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…

輸入參數latlngbody必填leveltitleobjectpayloadregionscategoryicon_typeparent_idfeature_id另有 10 個

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…

輸入參數campaign_idcomment_idssimulation_id必填workspace_scopeinclude_resolved

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…

輸入參數as_oflevel必填swing_pp必填simulation_id必填decay_halflifeworkspace_scopedecay_start_datetoward_candidate_id

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…

輸入參數cyclelevel必填chambersimulation_id必填workspace_scope

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…

輸入參數qmodecyclelevellimitowneroffsetrace_idcontest_idupdated_sinceworkspace_scope

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.

輸入參數fieldssimulation_id必填workspace_scope

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…

輸入參數grainlevel必填limitstateoffsetsimulation_id必填workspace_scope

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…

輸入參數grainlevel必填limitstateformatoffsetversion_aversion_bcampaign_id_acampaign_id_bexpected_hash_aexpected_hash_b另有 3 個

share_simulation

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

輸入參數sectionsttl_dayscampaign_idsimulation_id必填include_deltasinclude_impactworkspace_scope

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…

輸入參數levelregiondistrict_idregion_groupsimulation_id必填workspace_scope

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…

輸入參數mixmodelevelstate必填filter必填sourceweightsswing_ppassumptionmax_precinctssimulation_id必填workspace_scope另有 2 個

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…

輸入參數sectionworkspace_scope

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…

輸入參數workspace_scope

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…

輸入參數toollimitquerycursorcategoryworkflowworkspace_scopeexpected_catalog_version

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…

輸入參數party必填simulation_idworkspace_scope

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

輸入參數party必填statesharesstatessimulation_id必填include_rollupworkspace_scope

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…

輸入參數asofparty必填stateby_districtsimulation_id必填include_statesworkspace_scope

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…

輸入參數edits必填forcepartydry_runsimulation_id必填setup_evidenceworkspace_scopecheckpoint_labelexpected_version_hash

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.

輸入參數cyclelevelstageofficerebindcandidatecandidatesgeography_idsimulation_id必填workspace_scope

call_tool

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

輸入參數name必填arguments

版本歷史

1
  1. v0.2.0最新Sep 27, 2026

評分

已滿足適用檢查項的 72%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分

    請在註冊中心條目中發布圖示。

  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。