com.electionsmcp/electionsmcp

Est-ce que com.electionsmcp/electionsmcp est sûr ?

Au dernier audit MCP Hub, le serveur MCP « com.electionsmcp/electionsmcp » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 48 outils

• add_map_comment≈ 1792 tokens

  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…

  Paramètres, retour & exemple (22)

  Paramètres

  • lat · number · optionnel
    Free-point anchor latitude (use with lng).
  • lng · number · optionnel
    Free-point anchor longitude (use with lat).
  • body · string · requis
    The comment text (supports @mentions by email/handle).
  • level · string · optionnel
    Feature anchor level (county|precinct|state|house|state_senate|state_assembly). Defaults to the sim level.
  • title · string · optionnel
    Optional short name for the post (a strategy/target/event has one; plain chat does not — feeds fall back to a body excerpt). Indexed for full-text search alongside body.
  • object · object · optionnel
    Anchor the comment to an OBJECT (a strategy / strategy step / annotation / version / candidate / workspace person / canonical report widget), not a map place — the comment is ABOUT that object. A person ref must resolve inside this workspace and, when campaign-scoped, the person must be assigned to that campaign. A report_widget ref is verified against this exact saved scenario version.
  • payload · object · optionnel
    Category-specific structured fields, stored as-is. Examples — target: { priority, channel, universe_ref }; action: { status, assignee, due_at, priority }; need: { qty, unit, urgency }; event: { event_kind, starts_at, ends_at }.
  • regions · array · optionnel
    The post's MANY-TO-MANY location — the region/turf/shapefile ids this post covers (a multi-area comment's selected regions, a canvass turf, a target's shapes). ONE comment can anchor to MANY areas: pass every id here. Written to the post_regions junction ("what is happening in this region?" stays one indexed query) AND stamped by the server onto the comment's payload.regions, so every reader of the post gets the full set back and the open map frames all of it. Returns regions_saved = what actually landed.
  • category · string · optionnel · note | target | canvass | action | need | event | strategy
    UNIFIED WAR ROOM OBJECTS: what kind of floater this placement is. Every category shares the same anchor model and starts a thread; the category drives the icon, the War Room grouping, and which payload fields make sense. A canvass_kind implies category "canvass" automatically.
  • icon_type · string · optionnel
    The icon/subtype within the category — e.g. note: why|risk|fact|question; target: by role; canvass: the drop kind; action: follow_up|call|door|research|decision.
  • parent_id · string · optionnel
    Reply to this comment id (creates a thread; inherits the parent's anchor).
  • feature_id · string · optionnel
    Anchor to this feature (5-digit county FIPS / precinct external_id / 2-digit state FIPS / district GEOID).
  • attachments · array · optionnel
    Attachments on the message: [{name,url,mime,size,object_path?,kind?}]. An UPLOADED FILE rides as the object_path returned by /api/chat-upload — the bucket is private, so each read mints a fresh short-lived signed url into `url` (never store or share one; it expires). kind:"link" for pasted links; kind:"view" for a PINNED MAP VIEW whose url is a same-origin /sim?… deep link (the message carries the exact map context, and clicking the chip restores it).
  • campaign_id · string · optionnel
    Campaign that owns this War Room message. The simulation must be tagged into it. Omit only for scenario-global discussion.
  • region_kind · string · optionnel
    What grain the regions[] ids are (precinct|county|state|district). Defaults to the anchor level.
  • canvass_data · object · optionnel
    Optional structured data for a field pin: { label, status, support_score, contacted_at, … } — anything your campaign tracks per pin.
  • canvass_kind · string · optionnel · supporter | voter | door | target | note
    Make this a color-coded FIELD-MAP PIN (Map View canvassing) instead of a plain comment: supporter (green) | voter (amber) | door (blue) | target (red) | note (teal). Use with a point anchor (lng+lat) or a feature_id. The body is the pin label.
  • simulation_id · string · requis
  • audience_scope · object · optionnel
    Who can read this discussion or assignment. Replies and work originating in a discussion inherit its audience.
  • report_context · object · optionnel
    Bind this discussion to the exact immutable report widget the user is viewing. The report and widget must belong to simulation_id and the caller's workspace; the resulting receipt uses that report's pinned version and truthful widget coverage.
  • idempotency_key · string · optionnel
    Optional retry key. Replays return the same post and immutable context instead of duplicating the message.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "add_map_comment", "arguments": {"body": "texte", "simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• apply_swing_to_query≈ 1382 tokens

  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…

  Paramètres, retour & exemple (14)

  Paramètres

  • mix · number · optionnel
    mode:"mixed" only — the fraction of swing_pp delivered via persuasion (the rest via turnout).
  • mode · string · optionnel · persuasion | turnout | mixed
    HOW the swing happens (EM-008). persuasion = conversion (×2 margin, ballots hold); turnout = one-sided ballots (×1 margin, votes_total moves); mixed = mix persuasion + the rest turnout. Omit for the classic call.
  • level · string · optionnel · senate | governor | attorney_general | secretary_of_state | treasurer | house | state_senate | state_assembly
    The office these swung precincts model — folds them into that race's state rollup (same tag as set_precinct_pcts). REQUIRED for mode:"turnout"/"mixed" (the ballots ride that race's lever kernel; president excluded).
  • state · string · requis
    Postal, FIPS, or resolve_geography slug ("us-pa") — required, scopes the query (EM-056: all formats accepted; also fills from geo_id).
  • filter · object · requis
    Precinct property → condition map within the requested geography. Properties: external_id, GEOID, name, state, county, county_fips, shape_id, votes_dem, votes_rep, votes_total, pct_dem_lead, official_boundary, lat, lng, population, mhi, median_home, pct_bachelors, pct_foreign_born, unemp_pct, median_age, owner_occ_pct, modeled_margin_pp, modeled_pct_dem_lead, flipped, overridden. A bare scalar means exact equality; an array means membership. Object operators: gt, gte, lt, lte, in, not_in. Comparisons take finite numbers; in/not_in take arrays of scalars. Conditions are ANDed. pct_dem_lead is a baseline two-party share lead in -1..1. Scenario-scoped target_precincts, aggregate_precincts and apply_swing_to_query also accept modeled_margin_pp (D minus R over ALL modeled ballots, percentage points), modeled_pct_dem_lead (same margin / 100), modeled_share.CANDIDATE_ID (0..1 all-ballot share), flipped (winner differs from baseline, including ties) and overridden (saved precinct or county share override). These require a supported general statewide scenario with an allocated local model; missing shares never match numeric comparisons. Example: {external_id:{in:["48009-11"]},votes_total:{gte:500}}. Unknown properties/operators and malformed conditions are rejected before matching or writing.
  • source · string · optionnel
    mode calls that move ballots: stored on the lever's audit entry.
  • weights · object · optionnel
    Alternative to swing_pp: exact precinct external_id -> signed swing percentage points. Only these IDs change; all must be inside the state/filter with canonical ballots. Requires explicit D/R target, mode, statewide level and a cap covering the whole vector. President supports persuasion only. Optional target_margin_pp rescales a persuasion vector by a nonnegative factor (closest to 1 when several solutions exist), preserving its signs; target scope is weighted IDs only. Shares use sum-preserving 2-decimal rounding; receipt reports achieved margin/residual, clamps, weighted mean and one audit entry. Incremental; do not blindly replay after timeout.
  • swing_pp · number · optionnel
    Percentage-point swing toward the target candidate. mode:"turnout": the percent of each precinct's ballots added for the target side.
  • assumption · string · optionnel
    mode calls that move ballots: stored on the lever's audit entry.
  • max_precincts · integer · optionnel
    Safety cap on how many precincts get mutated.
  • simulation_id · string · requis
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • target_margin_pp · number · optionnel
    Alternative to swing_pp: desired margin of the target party over the other major party, as a percentage of all modeled ballots in the filtered cohort. Requires mode:persuasion, explicit toward_candidate_id and statewide level (including president). Cannot be combined with swing_pp.
  • toward_candidate_id · string · optionnel
    The candidate id receiving the swing (e.g. "D", "R", or a custom id). Inferred to the level's first candidate of opposite party if omitted.

  Exemple d'appel

  {"name": "apply_swing_to_query", "arguments": {"state": "texte", "filter": {}, "simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• apply_uniform_swing≈ 495 tokens

  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…

  Paramètres, retour & exemple (8)

  Paramètres

  • as_of · string · optionnel
    YYYY-MM-DD timeline point at which to evaluate the decayed swing. Default: decay_start_date (full magnitude). Only used when decay_halflife is set.
  • level · string · requis · president | senate | governor | house | state_senate | state_assembly | attorney_general | secretary_of_state
  • swing_pp · number · requis
  • simulation_id · string · requis
  • decay_halflife · number · optionnel
    Optional. Half-life in DAYS: past decay_start_date the applied swing halves every this-many days (exponential fade toward baseline). Omit for a permanent swing (today's behavior).
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • decay_start_date · string · optionnel
    YYYY-MM-DD the shift lands / peaks (decay measured forward from here). Default: today. Only used when decay_halflife is set.
  • toward_candidate_id · string · optionnel

  Exemple d'appel

  {"name": "apply_uniform_swing", "arguments": {"level": "president", "swing_pp": 1, "simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• billing_status≈ 238 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "billing_status", "arguments": {"workspace_scope": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• call_tool≈ 179 tokens

  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…

  Paramètres, retour & exemple (2)

  Paramètres

  • name · string · requis
    The exact tool name, as get_catalog returns it.
  • arguments · object · optionnel
    That tool's arguments, exactly as its get_catalog schema describes.

  Exemple d'appel

  {"name": "call_tool", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• commit_version≈ 521 tokens

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

  Paramètres, retour & exemple (7)

  Paramètres

  • title · string · optionnel
    Optional SHORT card title (<=80 chars), distinct from the longer summary — what the VERSIONS card shows as its heading, e.g. "Orange County flip".
  • summary · string · optionnel
    Human-readable note on what changed, e.g. "Flipped Orange County to D+40".
  • insight_ids · array · optionnel
    Optional — insight ids (ins_…) this version explains. Validated against the sim's insights; unknown ids are reported in `unlinked` and dropped.
  • scenario_id · string · requis
  • include_diff · boolean · optionnel
    Inline the full before/after diff in the response (can be very large). Default false: return compact diff_stats only; fetch the full diff via diff_versions when needed.
  • annotation_ids · array · optionnel
    Optional — annotation ids (pins/highlights/notes on this sim) this version explains. Validated against the sim's annotations; unknown ids are reported in `unlinked` and dropped, never invented.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "commit_version", "arguments": {"scenario_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• compare_simulations≈ 712 tokens

  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…

  Paramètres, retour & exemple (15)

  Paramètres

  • grain · string · optionnel · county | precinct | district
    Return canonical local outcomes instead of a chamber tally. county|precinct for president/statewide races; district|precinct for House and state-legislative races.
  • level · string · requis · president | senate | governor | house | state_senate | state_assembly | attorney_general | secretary_of_state
  • limit · integer · optionnel
  • state · string · optionnel
    Required for county/precinct comparison: one state postal code or FIPS.
  • format · string · optionnel · json | csv | geojson
    Local comparison table format; CSV/GeoJSON add a private complete-file download URL.
  • offset · integer · optionnel
  • version_a · string · optionnel
    Difference comparison: exact saved version of A. Omit only when its latest version matches the live model.
  • version_b · string · optionnel
    Difference comparison: exact saved version of B. Omit only when its latest version matches the live model.
  • campaign_id_a · string · optionnel
    Optional campaign custody for A when the model belongs to multiple readable campaigns. Does not grant access.
  • campaign_id_b · string · optionnel
    Optional campaign custody for B when the model belongs to multiple readable campaigns. Does not grant access.
  • expected_hash_a · string · optionnel
    Optional expected immutable version hash for A; mismatches refuse.
  • expected_hash_b · string · optionnel
    Optional expected immutable version hash for B; mismatches refuse.
  • simulation_id_a · string · requis
  • simulation_id_b · string · requis
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "compare_simulations", "arguments": {"level": "president", "simulation_id_a": "texte", "simulation_id_b": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• connection_status≈ 806 tokens

  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…

  Paramètres, retour & exemple (1)

  Paramètres

  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "connection_status", "arguments": {"workspace_scope": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"delta": {}, "affected": {}, "category": "texte", "latency_ms": 1, "workspace_id": "texte", "result_status": "success", "contract_version": "texte"}}

• create_scenario≈ 568 tokens

  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…

  Paramètres, retour & exemple (11)

  Paramètres

  • name · string · requis
  • tags · array · optionnel
  • race_id · string · optionnel
    Optional; the Race this scenario belongs to.
  • contest_id · string · optionnel
    Optional; sets the scenario's race_scope from a canonical contest_id.
  • baseline_id · string · optionnel
    Optional explicit source pin. Only 2024_president_mixed_grain is currently selectable. Known county sources return baseline_selection_unavailable; unreconciled sources return baseline_not_model_eligible; unknown IDs return unknown_baseline. No source is silently substituted.
  • campaign_id · string · optionnel
    Custom campaign to model inside its exact attached city boundary.
  • import_from · string · optionnel
    Optional; copy overrides+candidates from an existing scenario_id.
  • idempotency_key · string · optionnel
    Optional workspace-scoped retry key for listed races; required for custom campaign models. Identical retries return the same scenario and baseline version. Reusing a key with different creation inputs returns idempotency_conflict.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • boundary_version · string · optionnel
  • expected_campaign_revision · integer · optionnel

  Exemple d'appel

  {"name": "create_scenario", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• diff_versions≈ 358 tokens

  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…

  Paramètres, retour & exemple (6)

  Paramètres

  • limit · integer · optionnel
    Maximum changed precinct cells in this page. Summary counts cover the full version pair.
  • offset · integer · optionnel
    Use precinct_page.next_offset to continue in stable precinct-id order.
  • version_a · string · requis
  • version_b · string · requis
  • scenario_id · string · requis
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "diff_versions", "arguments": {"version_a": "texte", "version_b": "texte", "scenario_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• election_calendar≈ 299 tokens

  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…

  Paramètres, retour & exemple (3)

  Paramètres

  • cycle · integer · optionnel
    Defaults to the next election year from today.
  • state · string · optionnel
    Postal abbreviation ("PA") for the per-state 4-year horizon; omit for the national summary.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "election_calendar", "arguments": {"cycle": 1, "state": "texte", "workspace_scope": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_campaign_onboarding≈ 310 tokens

  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…

  Paramètres, retour & exemple (2)

  Paramètres

  • section · string · optionnel · connection | campaign | team | data | work | complete | all
    The next conversational step. Read connection first; all returns the complete guide when campaign tools are available.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "get_campaign_onboarding", "arguments": {"section": "connection", "workspace_scope": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_catalog≈ 1873 tokens

  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…

  Paramètres, retour & exemple (8)

  Paramètres

  • tool · string · optionnel
    Exact retained tool name — returns the complete inputSchema and versioned AI guidance matching its use-<tool> MCP prompt when it is present in this session's tools/list.
  • limit · integer · optionnel
    Maximum tool entries per discovery page, subject to the response byte budget. Repeat the same filters with next_cursor as cursor until null.
  • query · string · optionnel
    Text search over this session's retained tool names and descriptions. Ranked: exact name, name substring, then description matches.
  • cursor · string · optionnel
    Opaque next_cursor from the previous discovery page. Keep the same query, category and workflow; restart if the authorized catalog changed.
  • category · string · optionnel
    Browse one category (e.g. "Scenario") in bounded pages. The category count is the full matching inventory, not this page length.
  • workflow · string · optionnel · modeling | campaign_operations | imports | account_and_support | staff_support | discovery
    Opt into a workflow from the compact index. Filters browsing or search within the authorized inventory; never grants access or changes the connection profile.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • expected_catalog_version · string · optionnel
    Optional catalog_version from a previous tools/list or get_catalog response. Returns catalog_changed so clients can detect schema drift and refresh cached bindings.

  Exemple d'appel

  {"name": "get_catalog", "arguments": {"tool": "texte", "limit": 1, "query": "texte", "cursor": "texte", "category": "texte", "workflow": "modeling"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"delta": {}, "affected": {}, "category": "texte", "latency_ms": 1, "workspace_id": "texte", "result_status": "success", "contract_version": "texte"}}

• get_county_economic_and_wealth_profile≈ 444 tokens

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

  Paramètres, retour & exemple (6)

  Paramètres

  • fips · string · optionnel
    Optional 5-digit county FIPS code (e.g. "06087" for Santa Cruz County CA, "36061" for New York County NY) for a full county dossier.
  • sort · string · optionnel · avg_annual_wage_usd | economic_vitality_score | total_annual_payroll_usd | total_employees
    Sort field when ranking counties in a state (default avg_annual_wage_usd).
  • limit · integer · optionnel
    Maximum counties to return when ranking a state (default 50, max 200).
  • state · string · optionnel
    Optional two-letter state code (e.g. "CA", "TX", "NY") to rank counties across a state.
  • offset · integer · optionnel
    Pagination offset (default 0).
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "get_county_economic_and_wealth_profile", "arguments": {"fips": "texte", "sort": "avg_annual_wage_usd", "limit": 1, "state": "texte", "offset": 1, "workspace_scope": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_county_officials≈ 436 tokens

  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.

  Paramètres, retour & exemple (8)

  Paramètres

  • q · string · optionnel
    Optional name or title search query.
  • fips · string · optionnel
    Optional 5-digit county FIPS code (e.g. "48201" for Harris County TX, "17031" for Cook County IL).
  • limit · integer · optionnel
    Maximum officials to return (default 100, max 200).
  • party · string · optionnel
    Optional party filter.
  • state · string · optionnel
    Optional two-letter state code (e.g. "TX", "IL", "CA").
  • offset · integer · optionnel
    Pagination offset (default 0).
  • office_level · string · optionnel · county | municipal | judicial | school_board | statewide | state_legislative | federal
    Optional office level filter.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "get_county_officials", "arguments": {"q": "texte", "fips": "texte", "limit": 1, "party": "texte", "state": "texte", "offset": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_county_voter_turnout_and_registration≈ 475 tokens

  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…

  Paramètres, retour & exemple (7)

  Paramètres

  • sort · string · optionnel · ballots_cast_2024 | turnout_2024_pct | registered_voters | partisan_swing_2020_to_2024_pct | margin_2024_pct | ballots_cast_2026
    Sort order (default ballots_cast_2024).
  • tier · string · optionnel · tossup_battleground | lean_dem | lean_rep | safe_dem | safe_rep
    Optional competitiveness tier filter.
  • limit · integer · optionnel
    Maximum counties to return (default 100, max 500).
  • state · string · optionnel
    Optional two-letter state code (e.g. "PA", "GA", "NC", "MI", "WI", "AZ", "NV", "TX").
  • offset · integer · optionnel
    Pagination offset (default 0).
  • county_fips · string · optionnel
    Optional 5-digit county FIPS code (e.g. "37183" for Wake NC, "04013" for Maricopa AZ).
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "get_county_voter_turnout_and_registration", "arguments": {"sort": "ballots_cast_2024", "tier": "tossup_battleground", "limit": 1, "state": "texte", "offset": 1, "county_fips": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_early_voting_turnout≈ 624 tokens

  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…

  Paramètres, retour & exemple (10)

  Paramètres

  • state · string · requis
    Two-letter state postal code (e.g. "TX", "NC", "GA", "FL", "PA", "MI", "AZ").
  • office · string · optionnel
    Optional office substring filter (e.g. "U.S. Senate", "Governor").
  • district · string · optionnel
    Optional district code filter for legislative or congressional races (e.g. "10", "11").
  • source_id · string · optionnel
    Optional 64-character SHA-256 source identifier for a specific county/state return file.
  • county_fips · string · optionnel
    Optional 5-digit county FIPS code (e.g. "48081", "37021") to scope returns and turnout to one county.
  • office_level · string · optionnel · president | us_senate | us_house | governor | lt_governor | attorney_general | secretary_of_state | treasurer
    Optional canonical office level filter.
  • election_date · string · optionnel
    Optional election date in YYYY-MM-DD format (e.g. "2024-11-05", "2026-03-03", "2026-08-18"). Defaults to the most recent covered election for the state.
  • election_type · string · optionnel · general | primary | runoff | special | municipal | recall
    Optional election stage filter.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • include_precincts · boolean · optionnel
    When true, include per-precinct early voting, mail, election-day, and turnout breakdowns inside each race.

  Exemple d'appel

  {"name": "get_early_voting_turnout", "arguments": {"state": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_live_early_vote_returns≈ 384 tokens

  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…

  Paramètres, retour & exemple (6)

  Paramètres

  • limit · integer · optionnel
    Maximum county rows to return (default 100, max 500).
  • state · string · optionnel
    Optional two-letter state code (e.g. "NC", "VA", "GA", "PA").
  • offset · integer · optionnel
    Pagination offset (default 0).
  • county_fips · string · optionnel
    Optional 5-digit county FIPS code (e.g. "37183").
  • election_date · string · optionnel
    Election date in YYYY-MM-DD format (default "2026-11-03").
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "get_live_early_vote_returns", "arguments": {"limit": 1, "state": "texte", "offset": 1, "county_fips": "texte", "election_date": "texte", "workspace_scope": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_precinct_election_returns≈ 632 tokens

  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.

  Paramètres, retour & exemple (15)

  Paramètres

  • year · integer · optionnel
    Optional election year (e.g. 2024, 2022, 2026).
  • limit · integer · optionnel
    Maximum rows to return (default 100, max 500).
  • party · string · optionnel
    Optional party filter.
  • state · string · optionnel
    Two-letter state postal code (e.g. "TX", "NC", "GA", "PA").
  • office · string · optionnel
    Optional office name filter.
  • offset · integer · optionnel
    Pagination offset (default 0).
  • district · string · optionnel
    Optional legislative or congressional district code.
  • contest_id · integer · optionnel
    Optional RoutPoint contest identifier for single-contest precinct returns.
  • county_fips · string · optionnel
    Optional 5-digit county FIPS code.
  • election_id · integer · optionnel
    Optional RoutPoint election identifier.
  • office_level · string · optionnel · president | us_senate | us_house | governor | lt_governor | state_senate | state_assembly | state_house
    Optional canonical office level.
  • election_date · string · optionnel
    Optional election date in YYYY-MM-DD format.
  • election_type · string · optionnel · general | primary | runoff | special | municipal | recall
    Optional election stage (default general).
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • mapsmcp_precinct_id · string · optionnel
    Optional MapsMCP precinct UUID filter.

  Exemple d'appel

  {"name": "get_precinct_election_returns", "arguments": {"year": 1, "limit": 1, "party": "texte", "state": "texte", "office": "texte", "offset": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_scenario≈ 956 tokens

  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…

  Paramètres, retour & exemple (5)

  Paramètres

  • version_id · string · optionnel
    Optional; defaults to the latest version. When set, the response includes the full per-precinct `state` for that version.
  • scenario_id · string · requis
  • include_state · boolean · optionnel
    Include the full per-precinct `state` even for the latest version (for redrawing the map).
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • expected_version_hash · string · optionnel
    Optional exact content hash from list_scenario_versions. Requires version_id; a mismatch is refused rather than returning a different saved model.

  Exemple d'appel

  {"name": "get_scenario", "arguments": {"scenario_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"delta": {}, "affected": {}, "category": "texte", "latency_ms": 1, "workspace_id": "texte", "result_status": "success", "contract_version": "texte"}}

• get_simulation≈ 340 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • fields · ? · optionnel
    Optional read shaping: the string "summary" → the compact identity card (target <5KB); an array of dot-paths (e.g. ["id","mode","primary.asof","primary.grain_pref","updated_at"]) → just those values from the document (plus mode_truth / campaign_identity / provenance as pickable top-level paths). Omit for the full state.
  • simulation_id · string · requis
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "get_simulation", "arguments": {"simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_state_historical_turnout≈ 364 tokens

  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…

  Paramètres, retour & exemple (5)

  Paramètres

  • year · integer · optionnel
    Optional election year filter (1976 through 2026).
  • limit · integer · optionnel
    Maximum rows to return (default 100, max 500).
  • state · string · optionnel
    Optional two-letter state code (e.g. "PA", "GA", "MI", "WI", "CA", "TX").
  • offset · integer · optionnel
    Pagination offset (default 0).
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "get_state_historical_turnout", "arguments": {"year": 1, "limit": 1, "state": "texte", "offset": 1, "workspace_scope": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_tally≈ 396 tokens

  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…

  Paramètres, retour & exemple (5)

  Paramètres

  • cycle · integer · optionnel
    Election cycle for chamber control (level:"senate", chamber:true); default 2028. Ignored otherwise.
  • level · string · requis · custom | president | senate | governor | house | state_senate | state_assembly | attorney_general
  • chamber · boolean · optionnel
    level:"senate" only — return real chamber control ({D,R,I,seats_up,held_over,majority_status}) via the same math as senate_control, instead of the 50-state race scoreboard.
  • simulation_id · string · requis
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "get_tally", "arguments": {"level": "custom", "simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_view≈ 1161 tokens

  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…

  Paramètres, retour & exemple (17)

  Paramètres

  • view · string · optionnel · result | difference
    difference uses compare_simulation_id as B and simulation_id as A; returns the zero-centered B-minus-A color scale and exact county/precinct rows.
  • cycle · integer · optionnel
  • grain · string · optionnel · city | county | precinct
    With a state scoped, the grain of the local features returned: "county" (default) or "precinct". Applies to a statewide-level race (senate/governor/exec — its own overrides) AND to a PRIMARY sim scoped to a state (its per-county/precinct share-leader map from primary.feature_shares — mirroring render_view; a state-scoped primary defaults to county instead of the national delegate calendar). Ignored without a state.
  • level · string · optionnel · custom | president | senate | house | governor | attorney_general | secretary_of_state | treasurer
    Which map the view renders. Default president (or whatever set_view last scoped). house = HOUSE CONTROL (per-state delegation winners + the 218 banner); state_senate/state_assembly = one state's chamber (state required).
  • state · string · optionnel
    Optional postal code or 2-digit FIPS — scope the map to one state. president → its county breakdown; senate/governor/exec → that RACE's local county (default) or precinct features from its own overrides (each with modeled margin, baseline_margin, and a basis label: direct_override | county_override | state_override_uniform | presidential_proxy / race_returns) — never the presidential county baseline relabeled. On a PRIMARY sim, scoping to a state returns that state's per-COUNTY (default; grain:"precinct" for finer) share-leader features from primary.feature_shares — modeled counties filled by the county primary WINNER's candidate color, unmodeled grey — instead of the national delegate calendar (which is the unscoped view).
  • version_a · string · optionnel
    Difference comparison: exact saved version of A. Omit only when its latest version matches the live model.
  • version_b · string · optionnel
    Difference comparison: exact saved version of B. Omit only when its latest version matches the live model.
  • version_id · string · optionnel
    Exact saved version for a custom city model.
  • campaign_id_a · string · optionnel
    Optional campaign custody for A when the model belongs to multiple readable campaigns. Does not grant access.
  • campaign_id_b · string · optionnel
    Optional campaign custody for B when the model belongs to multiple readable campaigns. Does not grant access.
  • simulation_id · string · requis
  • expected_hash_a · string · optionnel
    Optional expected immutable version hash for A; mismatches refuse.
  • expected_hash_b · string · optionnel
    Optional expected immutable version hash for B; mismatches refuse.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • difference_scale_pp · number · optionnel
    Difference-only symmetric color extent: legend runs from negative this value through zero to positive this value. Omit to fit the largest absolute delta; out-of-scale values are disclosed as clamped.
  • compare_simulation_id · string · optionnel
    Compare B against simulation_id (A), using D-minus-R margin(B) minus margin(A). Requires one explicit state and county/precinct grain; both saved general-election models must share office/cycle/electorate and be readable.
  • expected_version_hash · string · optionnel

  Exemple d'appel

  {"name": "get_view", "arguments": {"simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• help≈ 237 tokens

  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…

  Paramètres, retour & exemple (1)

  Paramètres

  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "help", "arguments": {"workspace_scope": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_contests≈ 993 tokens

  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…

  Paramètres, retour & exemple (4)

  Paramètres

  • cycle · integer · optionnel
    Defaults to the next election year from today.
  • stage · string · optionnel · primary | general | all
    primary selects the dem_primary and rep_primary variants; general excludes them; all returns both.
  • geo_id · string · requis
    "us" (national), a state as "us-pa" / postal "PA" / FIPS "42", or a district id — all accepted.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "list_contests", "arguments": {"geo_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"delta": {}, "affected": {}, "category": "texte", "latency_ms": 1, "workspace_id": "texte", "result_status": "success", "contract_version": "texte"}}

• list_flipped≈ 393 tokens

  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…

  Paramètres, retour & exemple (7)

  Paramètres

  • grain · string · optionnel · state | county | precinct | district
  • level · string · requis · president | senate | governor | house | state_senate | state_assembly | attorney_general | secretary_of_state
  • limit · integer · optionnel
  • state · string · optionnel
    One postal code/FIPS for explicit county/precinct enumeration; may be inferred from a saved state race.
  • offset · integer · optionnel
  • simulation_id · string · requis
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "list_flipped", "arguments": {"level": "president", "simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_map_comments≈ 376 tokens

  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…

  Paramètres, retour & exemple (5)

  Paramètres

  • campaign_id · string · optionnel
    Exact campaign War Room to read. The simulation must be filed under it.
  • comment_ids · array · optionnel
    Read only these comments (a delta after a live event named them). The reply carries subset:true plus missing[] for ids that are not in this War Room.
  • simulation_id · string · requis
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • include_resolved · boolean · optionnel
    Include resolved comments (default true).

  Exemple d'appel

  {"name": "list_map_comments", "arguments": {"simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_primary_calendar≈ 296 tokens

  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…

  Paramètres, retour & exemple (3)

  Paramètres

  • party · string · requis · D | R
  • simulation_id · string · optionnel
    Optional. If given (and party=D), returns the sim's user-defined Dem calendar when one is set.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "list_primary_calendar", "arguments": {"party": "D"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_scenarios≈ 346 tokens

  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…

  Paramètres, retour & exemple (4)

  Paramètres

  • tags · array · optionnel
    Return only scenarios carrying any of these tags.
  • limit · integer · optionnel
  • offset · integer · optionnel
    Use previous next_offset with unchanged tags and limit. Ordered by updated_at descending, scenario_id ascending. Restart at 0 after inventory changes.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "list_scenarios", "arguments": {"tags": [], "limit": 1, "offset": 1, "workspace_scope": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_simulations≈ 535 tokens

  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…

  Paramètres, retour & exemple (11)

  Paramètres

  • q · string · optionnel
    Case-insensitive substring match on the simulation name.
  • mode · string · optionnel
    Filter by president modeling mode: general | dem_primary_2028 | rep_primary_2028.
  • cycle · integer · optionnel
    Filter by election cycle year (e.g. 2028).
  • level · string · optionnel
    Filter by office/level (e.g. president, senate, house, governor).
  • limit · integer · optionnel
    Max rows to return (pagination page size).
  • owner · string · optionnel
    Filter to sims created by this member user_id (the stable UUID from list_members) — "my sims" / "Dana's sims". Sims saved before identity stamping have no owner and never match.
  • offset · integer · optionnel
    Rows to skip before returning (pagination cursor).
  • race_id · string · optionnel
    Filter to sims bound to this race_id.
  • contest_id · string · optionnel
    Filter to sims bound to this contest_id.
  • updated_since · string · optionnel
    Only sims modified at or after this ISO timestamp/date.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "list_simulations", "arguments": {"q": "texte", "mode": "texte", "cycle": 1, "level": "texte", "limit": 1, "owner": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• lookup_address≈ 344 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • address · string · requis
    A full street address ("123 Main St, Dallas, TX"), a 5-digit ZIP, a district code ("NC-4", "AK-AL"), a state name/abbreviation, or a canonical state/House geography ID.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • include_officials · boolean · optionnel
    Attach the sitting officeholder for each resolved seat (from the committed legislator file).

  Exemple d'appel

  {"name": "lookup_address", "arguments": {"address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• primary_batch_edit≈ 775 tokens

  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…

  Paramètres, retour & exemple (9)

  Paramètres

  • edits · array · requis
    Ordered heterogeneous list of primary edits, each an object {op, …opArgs}. op is one of set_primary_shares, set_primary_county_shares, set_primary_precinct_shares, set_primary_candidates, set_primary_asof, clear_primary_shares, define_dem_calendar, clear_dem_calendar, set_primary_grain_pref, set_primary_demo_levers. The remaining fields are exactly the args that single-edit tool takes, e.g. {"op":"set_primary_shares","party":"d","state":"SC","shares":{"newsom":31,"harris":24}}. Applied in array order onto the working copy.
  • force · boolean · optionnel
    Apply despite soft WARNINGS (just-over-100 totals, viability flags, mode/geo/calendar notes). Still BLOCKS on hard errors (unknown candidate, malformed edit, shares over 100.5). Default false.
  • party · string · optionnel
    Default party (d/r) for edits that omit their own party. Defaults to the sim's primary party.
  • dry_run · boolean · optionnel
    DEFAULT true — preview only: returns before/after/delta/warnings/errors/viability_flags and writes NOTHING. Pass false to actually apply.
  • simulation_id · string · requis
    The scenario/simulation to edit (sim_…).
  • setup_evidence · object · optionnel
    For automatic public-profile initialization: {kind:"primary_profile_start",model:"geographic-context-v1",profile_version:"2026-09-05.v1",ranking:[{id,name}]}. Use the same ordered ranking; the server validates the catalog and final roster/shares before one atomic save. Dry runs return proposed evidence; only applied evidence with version identity confirms success.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • checkpoint_label · string · optionnel
    Optional label for the pre-batch rollback checkpoint version created on apply.
  • expected_version_hash · string · optionnel
    Copy expected_version_hash from the setup dry run to refuse overwriting an intervening edit. Exact already-applied replay returns the existing version.

  Exemple d'appel

  {"name": "primary_batch_edit", "arguments": {"edits": [], "simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• render_chart≈ 2168 tokens

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

  Paramètres, retour & exemple (29)

  Paramètres

  • asof · integer|null · optionnel
    For the primary charts — evaluate the race at this calendar checkpoint (contests counted), the same asof roll_up_primary takes: standings/clinch totals, the momentum timeline's end, and the calendar strip's counted set all stop there. Omit to use the scenario's STORED playhead (set_primary_asof) when one is set, else the full projected calendar. The response echoes the effective asof + contests_counted so a caption like "Through FL" can be verified against the data (tk_2840156e3f1d8b).
  • type · string · requis · delegate_standings | clinch_dial | delegate_momentum | calendar_strip | ranking_board | swing_bars | chamber_control | seat_hemicycle
    Which widget. share_comparison = saved candidate shares before/after, with paired version anchors and one state. Primary: delegate_standings (bars+clinch), clinch_dial (gauge), delegate_momentum (lines), calendar_strip (calendar grid), ranking_board (portrait tiles ranked by delegates + per-candidate clinch state/date; response carries the rows as data). General: swing_bars (state Δ vs 2024), chamber_control (down-ballot D/R scorecard), seat_hemicycle (the 1200×630 parliament-arch CONTROL CARD — every seat a dot, majority tick, big D/R counts), decisive_seats (the 1200×630 closest-races board with margin-band ratings + FLIP tags).
  • cycle · integer · optionnel
    Election cycle for seat_hemicycle / decisive_seats (defaults to the sim's cycle, else 2026) — drives the Senate class + governor calendar.
  • level · string · optionnel · president | senate | governor | attorney_general | secretary_of_state | treasurer
    share_comparison only: statewide office; defaults to the saved scope. Both versions must match office, state, cycle and general-election stage.
  • party · string · optionnel · d | r
    For the primary charts — which party's race (defaults to the sim's primary mode).
  • share · boolean · optionnel
    PUBLISH to a hostable URL: mints a share token and returns share.hosted_image_url / hosted_svg_url that resolve for ANYONE (cross-workspace, embeddable). Default false. Revoke with revoke_share(token).
  • state · string · optionnel
    State postal or FIPS. Required for share_comparison and state-leg seat_hemicycle/decisive_seats.
  • style · object · optionnel
    Optional brand overrides for the supported themed charts. Does not remove attribution or change candidate colors or model data.
  • theme · string · optionnel · control | analyst | field | civic | accessible | broadcast | terrain | print
    Chart audience palette, using the map-theme registry. Supported by primary charts, swing_bars and chamber_control. Default control.
  • title · string · optionnel
    Optional eyebrow/title for the chart.
  • clinch · boolean · optionnel
    ranking_board only — show each candidate's clinch line on the tiles (CLINCHES <state> · <date>, or how many delegates short). Default true; pass false for a name+delegates-only board. The response's rows[] carry the clinch data either way.
  • format · string · optionnel · svg | png
    Image format. Default svg (png needs the resvg renderer; degrades to svg if absent).
  • office · string · optionnel · house | senate | governor | state_senate | state_assembly
    For seat_hemicycle / decisive_seats — which chamber (default house). state_senate/state_assembly also need state.
  • version_a · string · optionnel
    Difference comparison: exact saved version of A. Omit only when its latest version matches the live model.
  • version_b · string · optionnel
    Difference comparison: exact saved version of B. Omit only when its latest version matches the live model.
  • overlay_race · object · optionnel
    The single race to swap in from overlay_from_simulation_id: {office, state, district}. office must match the card's chamber; statewide offices need only state; house takes the district GEOID ("0604") or the bare number with its state; state chambers take the district external_id.
  • campaign_id_a · string · optionnel
    Optional campaign custody for A when the model belongs to multiple readable campaigns. Does not grant access.
  • campaign_id_b · string · optionnel
    Optional campaign custody for B when the model belongs to multiple readable campaigns. Does not grant access.
  • simulation_id · string · optionnel
    Scenario to render; for share_comparison this is A, or the single model with version_a/version_b.
  • highlight_race · object · optionnel
    Mark one race on the card (same shape as overlay_race): its dot wears an amber ring on seat_hemicycle, and decisive_seats always includes it on the board with its true closest-races rank.
  • share_ttl_days · number · optionnel
    Days the shared URL stays live (default 90, max 365). Only with share:true.
  • expected_hash_a · string · optionnel
    Optional expected immutable version hash for A; mismatches refuse.
  • expected_hash_b · string · optionnel
    Optional expected immutable version hash for B; mismatches refuse.
  • simulation_id_a · string · optionnel
    share_comparison only: A model, alternative to simulation_id. Conflicting aliases refuse.
  • simulation_id_b · string · optionnel
    share_comparison only: B model in the same contest. Omit for two explicit versions of A.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • compare_simulation_id · string · optionnel
    share_comparison only: alias for simulation_id_b.
  • context_simulation_id · string · optionnel
    seat_hemicycle / decisive_seats only — compute the WHOLE chamber rollup from THIS scenario (a linked national/statewide view's scenario) instead of simulation_id. Pair with overlay_from_simulation_id + overlay_race to swap exactly one race's result in from a campaign's scenario: one seat changes hands, the counts move by that seat, nothing else. The two scenarios must model the same cycle and be general-election models — a disagreement is a typed refusal (context_cycle_mismatch / context_mode_mismatch), never a silent mix.
  • overlay_from_simulation_id · string · optionnel
    seat_hemicycle / decisive_seats only — the scenario that supplies the ONE overlaid race's modeled result. Travels with overlay_race; passing one without the other is refused (overlay_incomplete).

  Exemple d'appel

  {"name": "render_chart", "arguments": {"type": "delegate_standings"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• render_view≈ 2151 tokens

  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…

  Paramètres, retour & exemple (28)

  Paramètres

  • asof · integer|null · optionnel
    PRIMARY sims — render the delegate banner/standings AS OF this calendar checkpoint (contests counted; the same asof roll_up_primary / render_chart take). Omit to honor the scenario's STORED playhead (set_primary_asof) so the served image matches the viewer's scoreboard; null = the full projected calendar. The county/precinct share-leader FILLS are the scenario's stored shares and do NOT move with asof — only the delegate banner does. The primary mode + party are auto-detected from the sim's mode (dem_primary_2028 / rep_primary_2028); there is no mode/party arg. Ignored for general-election renders (the response echoes the effective asof when it applied).
  • view · string · optionnel · result | swing | difference
    "result" (default) = the outcome map; "swing" = colour by margin CHANGE vs the baseline (where the scenario MOVES the map). "difference" = margin(B)-margin(A), requires compare_simulation_id and one explicit state; supports saved general-election county/precinct maps, with a zero-centered in-frame legend. It refuses unallocated whole-race edits. Result/swing work at NATIONAL scope (president: every state by its swing), STATE scope (president county map AND the statewide-race local county/precinct maps), and CUSTOM maps.
  • grain · string · optionnel · county | precinct | house | state_senate | state_assembly
    When scoped to ONE state (state/geo_id/feature_id), the geographic grain to render: "county" (default) per-county; "precinct" per-precinct (finest, within-county) — both work at president level AND at the statewide-race levels (senate/governor/exec, which render that race's own overrides/fold, tk_3c0569e9b02541); or a DISTRICT layer (president level only) — "house" = U.S. congressional districts (us-cd119), "state_senate" = state-senate districts (us-sldu), "state_assembly" = state-house districts (us-sldl). Districts are fetched on-demand and filled by their vote baseline (House: county→CD presidential aggregation; state-leg: RoutPoint 2024 returns where covered, else presidential-lean) + the scenario's district overrides (set_performance at that level). A few states lack a layer and fall back to county.
  • level · string · optionnel · president | senate | house | governor | attorney_general | secretary_of_state | treasurer
    Which map to render. Default president. house = HOUSE CONTROL: states shaded by delegation majority, D/R seat tally, 218 banner (for one state's district map use grain:"house" with a state scope instead).
  • share · boolean · optionnel
    PUBLISH this map to a hostable URL: mints a share token and returns share.hosted_image_url / hosted_svg_url + a public page_url (/f/<token>) that resolve for ANYONE — cross-workspace, embeddable in an <img> or iframe. Default false (URLs are owner/public-scoped only). Anyone with the link sees the map; revoke with revoke_share(token).
  • state · string · optionnel
    Optional — scope the image to a state (postal "NC" or 2-digit FIPS). president → that state's per-county choropleth; senate/governor/exec → that RACE's LOCAL county map from its own overrides (5-digit county edits + its state override as uniform swing) over the labeled inherited-proxy baseline — never a presidential map substituted (tk_3c0569e9b02541). Other levels ring the state on the national map.
  • theme · string · optionnel
    MAP THEME preset for the rendered image (list_map_themes: control | analyst | field | civic | accessible | broadcast | terrain) — the SAME token resolution the live wall uses, so a civic-themed report map and the analyst on-screen map disagree only in paint, never in data. Omit = the classic dark card.
  • title · string · optionnel
    CUSTOM MAP: a title for the card (e.g. "Rust Belt swing"). Defaults to the state list (or the region group / region name).
  • format · string · optionnel · svg | png
    Image format. Default svg (png needs the resvg renderer on the host; degrades to svg if absent).
  • geo_id · string · optionnel
    Optional — a geo slug like "us-nc" to scope to that state.
  • layers · object · optionnel
    Draw saved highlight annotations on matching visible geography. Omit to honor set_view layers.highlights (default true); false hides them for this export only. Pins and notes are not rendered.
  • region · string · optionnel
    CUSTOM MAP — with region_group, render exactly ONE region in the group (its slug).
  • states · array · optionnel
    CUSTOM MAP (president): a list of states (postal "PA" or 2-digit FIPS) → a cropped county choropleth of just those states' counties, in their real relative positions, zoomed to the region. Combine with features[]. e.g. ["PA","OH","MI"] for a Rust Belt map.
  • features · array · optionnel
    CUSTOM MAP (president): an explicit list of geo_ids to include — county FIPS (5-digit), state FIPS (2-digit), or "us-xx". Hand-pick any counties across states; the map crops to exactly them. Combine with states[].
  • version_a · string · optionnel
    Difference comparison: exact saved version of A. Omit only when its latest version matches the live model.
  • version_b · string · optionnel
    Difference comparison: exact saved version of B. Omit only when its latest version matches the live model.
  • feature_id · string · optionnel
    Optional — a state fips (37) or county/precinct id (37xxx) to scope to its state.
  • region_group · string · optionnel
    CUSTOM MAP — a saved workspace map region-group slug. Expands to its member counties or states; add region to render one named region. Ignored if states[] or features[] are passed.
  • campaign_id_a · string · optionnel
    Optional campaign custody for A when the model belongs to multiple readable campaigns. Does not grant access.
  • campaign_id_b · string · optionnel
    Optional campaign custody for B when the model belongs to multiple readable campaigns. Does not grant access.
  • simulation_id · string · requis
  • share_ttl_days · number · optionnel
    Days the shared URL stays live (default 90, max 365). Only with share:true.
  • expected_hash_a · string · optionnel
    Optional expected immutable version hash for A; mismatches refuse.
  • expected_hash_b · string · optionnel
    Optional expected immutable version hash for B; mismatches refuse.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • comparison_layout · string · optionnel · difference | triptych
    Difference-only 1200x630 card: one B-minus-A map (default), or the same-grain A | B | B-minus-A maps with explicit legends.
  • difference_scale_pp · number · optionnel
    Difference-only symmetric color extent: legend runs from negative this value through zero to positive this value. Omit to fit the largest absolute delta; out-of-scale values are disclosed as clamped.
  • compare_simulation_id · string · optionnel
    Compare B against simulation_id (A), using D-minus-R margin(B) minus margin(A). Requires one explicit state and county/precinct grain; both saved general-election models must share office/cycle/electorate and be readable.

  Exemple d'appel

  {"name": "render_view", "arguments": {"simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• resolve_candidate≈ 469 tokens

  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…

  Paramètres, retour & exemple (6)

  Paramètres

  • name · string · requis
    A candidate or officeholder name — full ("Lauren Boebert"), last-name ("Boebert"), or any registry alias. Matching folds free-typed names onto the canonical person.
  • cycle · integer · optionnel
    Optional — keep only matches whose next_race is in this cycle (e.g. 2026).
  • limit · integer · optionnel
    Max people to return when a name is ambiguous (default 8).
  • party · string · optionnel
    Optional — keep only matches of this party (D/R/I), normalized by leading letter. For a stage/party-scoped picker.
  • office · string · optionnel
    Optional — keep only matches whose current OR next-race office matches (house, senate, governor, state_senate, state_assembly, …); the "us_" prefix is optional ("house" == "us_house").
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "resolve_candidate", "arguments": {"name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• resolve_geography≈ 313 tokens

  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…

  Paramètres, retour & exemple (3)

  Paramètres

  • year · integer · optionnel
    Disambiguates post-redistricting boundaries; defaults to current cycle.
  • query · string · requis
    "CA-03", "El Dorado County CA", "the 4th state senate district in California", "Pennsylvania"
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "resolve_geography", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• roll_up_primary≈ 1353 tokens

  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…

  Paramètres, retour & exemple (7)

  Paramètres

  • asof · integer|null · optionnel
    Optional. Contests counted; omit/null = full calendar.
  • party · string · requis · D | R
  • state · string · optionnel
    Optional. Scope the read to ONE contest (postal/FIPS/name): returns a `state` block with that contest's calendar position, modeling grain, and delegate allocation — and when the state sits BEYOND this call's asof, the response says so EXPLICITLY (top-level excluded_by_asof:true + contest_index + current_asof, never a silent absence). The "is FL on the map?" one-call answer.
  • by_district · boolean · optionnel
    Optional (Democratic only). Also return district_allocation: the SAME authoritative count broken out by DNC Rule 14 pool — per state, the district/at-large/PLEO pool sizes, and per congressional district its delegates, the threshold used, whether it used district-specific shares (modeled:true) or the statewide share, and who won its delegates; standings carry district_delegates + statewide_delegates per candidate. authoritative:true — it is not a second count; its totals equal the top-level standings.
  • simulation_id · string · requis
  • include_states · boolean · optionnel
    Optional. Also return by_state[]: per voted contest — delegates each candidate won, plus eff_shares (the effective per-state candidate shares after the county/precinct rollup), modeled_by ("precinct"|"county"|"state"|null — which grain drove the state), modeled_count, and coverage_pct (grain-relative % of 2024 turnout modeled, or null). For must-win / anchor-state analysis and source/coverage display. When this call's asof cuts off states that HAVE durable modeling, the response also carries excluded_modeled_states[] + current_asof so those states are named, never silently missing from by_state.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "roll_up_primary", "arguments": {"party": "D", "simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"delta": {}, "affected": {}, "category": "texte", "latency_ms": 1, "workspace_id": "texte", "result_status": "success", "contract_version": "texte"}}

• roll_up_race≈ 1207 tokens

  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…

  Paramètres, retour & exemple (6)

  Paramètres

  • level · string · optionnel · custom | president | senate | governor | attorney_general | secretary_of_state | treasurer | house
  • region · string · optionnel
    Optional — with region_group, scope to exactly ONE region in the group (its slug), rolling up only that region's member counties.
  • district_id · string · optionnel
    District external id (for level=president/senate/governor, the state). EM-056: accepts a resolve_geography handle in any format — the slug "us-pa", postal "PA", or FIPS "42" — and also reads geo_id/state as aliases.
  • region_group · string · optionnel
    Optional saved county-grain workspace map region-group slug. Returns one modeled race rollup per named region.
  • simulation_id · string · requis
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "roll_up_race", "arguments": {"simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"delta": {}, "affected": {}, "category": "texte", "latency_ms": 1, "workspace_id": "texte", "result_status": "success", "contract_version": "texte"}}

• search_candidates≈ 411 tokens

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

  Paramètres, retour & exemple (5)

  Paramètres

  • q · string · optionnel
    Optional — case-insensitive substring on the candidate name or any alias (typeahead).
  • limit · integer · optionnel
    Max results (default 50). `total` reports the full match count; `truncated:true` when the list was trimmed.
  • party · string · optionnel
    Optional — only this party (D/R/I/L/G), normalized by leading letter.
  • office · string · optionnel
    Optional — match the registry office label. Keywords president / senate / house / governor are normalized; anything else is a case-insensitive substring on the label. The "us_" prefix is ignored.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "search_candidates", "arguments": {"q": "texte", "limit": 1, "party": "texte", "office": "texte", "workspace_scope": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_candidates≈ 423 tokens

  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…

  Paramètres, retour & exemple (5)

  Paramètres

  • level · string · requis · president | senate | governor | house | state_senate | state_assembly | attorney_general | secretary_of_state
  • candidates · array · requis
  • simulation_id · string · requis
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • expected_version · string · optionnel
    The last-read updated_at token; custom model writes refuse stale edits.

  Exemple d'appel

  {"name": "set_candidates", "arguments": {"level": "president", "candidates": [], "simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_performance≈ 794 tokens

  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…

  Paramètres, retour & exemple (11)

  Paramètres

  • level · string · optionnel · custom | president | senate | governor | attorney_general | secretary_of_state | treasurer | house
    EM-136: explicit office for the override. A bare state geo (us-pa) otherwise defaults to senate — pass level to target president or governor instead (president is stored as a state-level aggregate that roll_up_race and get_view honor). For a district geo it must match the geo grain. tk_3c0569e9b02541: a COUNTY geo (us-me-county-23001) accepts any STATEWIDE office — level:"senate"/"governor"/exec stores the county edit in THAT race's store, folding into its state rollup with precinct > county > state > baseline precedence (default without level stays president). A PRECINCT geo (us-me-vtd-…) with level tags the edit's office so it folds into that race's statewide total (same tag set_precinct_pcts writes).
  • geo_id · string · requis
  • margin · number · optionnel
    Shorthand for two-candidate D−R margin in points; sets D/R shares around 50.
  • shares · object · requis
    candidate_id → share. Accepts 0–1 or 0–100.
  • turnout · number · optionnel
    0–1 expected turnout (stored as metadata on precinct overrides).
  • rebalance · string · optionnel · undecided | proportional
  • scenario_id · string · requis
    The simulation_id (scenario_id alias until the scenario model lands).
  • total_votes · integer · optionnel
    Explicit vote volume for a custom campaign city or reviewed precinct. Use level:"custom" and geo_id from get_campaign_vote_data. A precinct requires its own total; source-election turnout is never copied automatically.
  • simulation_id · string · optionnel
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • expected_version · string · optionnel
    Optional optimistic-concurrency token: the scenario updated_at you last read. If the scenario changed since, the write is refused with version_conflict + the current token instead of overwriting concurrent edits.

  Exemple d'appel

  {"name": "set_performance", "arguments": {"geo_id": "texte", "shares": {}, "scenario_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_primary_shares≈ 507 tokens

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

  Paramètres, retour & exemple (7)

  Paramètres

  • party · string · requis · D | R
  • state · string · optionnel
    SINGLE-STATE mode: State FIPS ("19") or 2-letter abbr ("IA"). Provide `state`+`shares` OR `states`, not both.
  • shares · object · optionnel
    SINGLE-STATE mode: Map of candidate_id → percentage (0-100), e.g. {"vance": 42, "desantis": 30}. Must reference set_primary_candidates ids. Empty ({}) un-models the state.
  • states · object · optionnel
    BATCH mode: Map of state (FIPS or 2-letter abbr) → its {candidate_id: pct} shares, e.g. {"SC":{"newsom":31,"harris":24},"NH":{...}}. Writes all states in one atomic call; an invalid state fails the whole batch (nothing is written). Empty ({}) for a state un-models it.
  • simulation_id · string · requis
  • include_rollup · boolean · optionnel
    BATCH mode only: also return the full delegate roll_up alongside the default trimmed `delta` summary. Ignored in single-state mode (which always echoes the full roll_up).
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "set_primary_shares", "arguments": {"party": "D", "simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_race_scope≈ 743 tokens

  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.

  Paramètres, retour & exemple (10)

  Paramètres

  • cycle · integer · optionnel
  • level · string · optionnel · president | senate | governor | attorney_general | secretary_of_state | treasurer | house | state_senate
    DEPRECATED alias for `office` (kept for back-compat). Prefer `office`.
  • stage · string · optionnel · general | d_primary | r_primary
  • office · string · optionnel · president | senate | governor | attorney_general | secretary_of_state | treasurer | house | state_senate
    The office (seat) this race is for. This is the canonical parameter name; the older `level` is still accepted as an alias.
  • rebind · boolean · optionnel
    Deliberately re-district a campaign already bound to a DIFFERENT geography. Without it, re-scoping a bound sim is rejected (scope_locked) — a campaign is tied to the district it was created in.
  • candidate · string · optionnel
    A candidate/officeholder name ("Lauren Boebert") — resolved via resolve_candidate to their office + geography + cycle, so you scope their race in ONE call and they are auto-added to the roster as the incumbent. Ignored if geography_id is also given. If the name is in no source (never guessed) the call errors — pass office + geography_id instead.
  • candidates · array · optionnel
    Optional array of real candidates running this race: [{id, name, party, color, incumbent?}]. Overwrites the office's candidate list. If omitted, keeps existing candidates.
  • geography_id · string · optionnel
    Accepts the canonical resolve_geography slug at every office — president "us" / "US"; senate & governor "us-pa", "PA", or FIPS "42"; house "us-ny-cd-17", "NY-17", or the FIPS+CD external_id "3617". State-leg takes its district external_id from list_features. Omit when you pass `candidate`.
  • simulation_id · string · requis
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "set_race_scope", "arguments": {"simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_turnout≈ 1031 tokens

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

  Paramètres, retour & exemple (17)

  Paramètres

  • clear · boolean · optionnel
    Race-scoped levels only: true removes every turnout (ballots) factor on this level and its set_turnout levers, returning ballots to the baseline. Vote-share edits stay. Do not combine with turnout_change_pct or a cohort.
  • immig · number · optionnel
  • level · string · optionnel · president | senate | governor | house | state_senate | state_assembly | attorney_general | secretary_of_state
    president (default) = the classic ACS-threshold dials below. Any other level = the race-scoped ballots lever (turnout_change_pct + cohort).
  • source · string · optionnel
    Where this user-authored assumption came from (user statement, field report, or source citation) — stored on the lever's audit entry.
  • college · number · optionnel
  • geo_ids · array · optionnel
    Explicit geography cohort — 5-digit county FIPS on statewide levels (e.g. "23005" = Cumberland ME), district external ids on house/state-leg, or precinct external ids (they contain a dash, e.g. "34013-0001") on any race level. Precinct ids apply at precinct grain where the scenario uses the canonical precinct baseline; ids that cannot take a factor are returned in excluded[] with a reason (never widened to a county). The receipt's precinct_impact lists the counties (and districts) that move.
  • hiUnemp · number · optionnel
  • lowHome · number · optionnel
  • counties · array · optionnel
    Alias of geo_ids for county cohorts.
  • highHome · number · optionnel
  • criterion · object · optionnel
    ACS-style county matcher (statewide levels): e.g. {field:"population", op:"lt", value:30000} = rural counties. Filters WITHIN geo_ids when both are passed; scope a bare criterion with state_fips.
  • assumption · string · optionnel
    The modeling assumption in plain words (e.g. "youth demobilization scenario") — stored on the lever's audit entry.
  • state_fips · string · optionnel
    2-digit state FIPS to scope a criterion cohort to one state (e.g. "23" = Maine).
  • simulation_id · string · requis
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.
  • turnout_change_pct · number · optionnel
    Race-scoped levels only: percent change to BALLOTS cast in the matched geography (-12 = 12% fewer, +8 = 8% more). Composes multiplicatively with prior levers; the factor is clamped to [0.05, 5].
  • toward_candidate_id · string · optionnel

  Exemple d'appel

  {"name": "set_turnout", "arguments": {"simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_view≈ 1094 tokens

  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…

  Paramètres, retour & exemple (17)

  Paramètres

  • asof · integer|null · optionnel
    The primary calendar playhead — contests counted in the race-so-far (the number set_primary_asof takes). null = full calendar. Writes sim.primary.asof (the store the viewer's scoreboard/map run at), so this one DOES change the sim document. Primary sims only (a general sim answers with an asof_ignored warning).
  • rail · string · optionnel · select | notes | strategy | none
    Which right-rail panel the viewer should have open.
  • zoom · number · optionnel
    Optional camera zoom; omit to fit the geo's bounds.
  • cycle · integer · optionnel
  • level · string · optionnel · custom | president | senate | governor | attorney_general | secretary_of_state | treasurer | house
    The map/level the view should show.
  • stage · string · optionnel · general | d_primary | r_primary | top_two
    The race stage the viewer should see. Persisted on view_state + broadcast live; a primary-mode sim's own mode remains the identity truth (this is the VIEW).
  • state · string · optionnel
    Postal code or 2-digit FIPS to scope to (pass empty string to clear to the national view).
  • layers · object · optionnel
    View toggles such as precincts/highlights plus the canonical "actuals:pres_2024" baseline layer.
  • source · string · optionnel · auto | state | county | precinct | flat
    The per-state Outcome SOURCE control (which grain governs the shown outcome). Stored on view_state; the sim's own grain_pref pin stays set_primary_grain_pref's job.
  • contest · string · optionnel
    Playhead targeting by contest instead of a number: a state postal code ("FL"), 2-digit FIPS, or full name — the playhead jumps to INCLUDE that contest (same semantics as set_primary_asof).
  • map_grain · string · optionnel · states | counties | precincts | state | county | precinct
    The Map View grain toggle: states | counties | precincts (singular accepted, stored plural).
  • map_theme · string · optionnel
    Pin a MAP THEME audience preset on this view (list_map_themes has the registry: control | analyst | field | civic | accessible | broadcast | terrain). The open viewer restyles live; "none" clears the pin. Colors only — data, winners and margins never change.
  • selected_geo · object · optionnel
    The selected feature on the map ({level, feature_id} — e.g. {level:"county", feature_id:"12086"} for Miami-Dade). Pass feature_id:"" to clear the selection.
  • camera_geo_id · string · optionnel
    Optional geo to frame the camera on (defaults to the scoped state). 2-digit state / 5-digit county / district GEOID / precinct id.
  • contest_index · integer · optionnel
    Playhead targeting by 1-based calendar ordinal (list_primary_calendar order).
  • simulation_id · string · requis
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "set_view", "arguments": {"simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• share_simulation≈ 463 tokens

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

  Paramètres, retour & exemple (7)

  Paramètres

  • sections · array · optionnel
    Optional public-share section allowlist. Single-race shares remain race-scoped even when impact is requested.
  • ttl_days · integer · optionnel
  • campaign_id · string · optionnel
    Optional campaign that contains this simulation. The share is authorized against that campaign and its frozen context/manifest retain the campaign id.
  • simulation_id · string · requis
  • include_deltas · boolean · optionnel
    Include modeled margin/share deltas from the canonical baseline for this exact race.
  • include_impact · boolean · optionnel
    Include national impact only for an unscoped national model. Ignored for a single-race or primary scope.
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "share_simulation", "arguments": {"simulation_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• target_precincts≈ 909 tokens

  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…

  Paramètres, retour & exemple (12)

  Paramètres

  • limit · integer · optionnel
  • filter · object · optionnel
    Precinct property → condition map within the requested geography. Properties: external_id, GEOID, name, state, county, county_fips, shape_id, votes_dem, votes_rep, votes_total, pct_dem_lead, official_boundary, lat, lng, population, mhi, median_home, pct_bachelors, pct_foreign_born, unemp_pct, median_age, owner_occ_pct, modeled_margin_pp, modeled_pct_dem_lead, flipped, overridden. A bare scalar means exact equality; an array means membership. Object operators: gt, gte, lt, lte, in, not_in. Comparisons take finite numbers; in/not_in take arrays of scalars. Conditions are ANDed. pct_dem_lead is a baseline two-party share lead in -1..1. Scenario-scoped target_precincts, aggregate_precincts and apply_swing_to_query also accept modeled_margin_pp (D minus R over ALL modeled ballots, percentage points), modeled_pct_dem_lead (same margin / 100), modeled_share.CANDIDATE_ID (0..1 all-ballot share), flipped (winner differs from baseline, including ties) and overridden (saved precinct or county share override). These require a supported general statewide scenario with an allocated local model; missing shares never match numeric comparisons. Example: {external_id:{in:["48009-11"]},votes_total:{gte:500}}. Unknown properties/operators and malformed conditions are rejected before matching or writing.
  • geo_id · string · optionnel
    District or state geography — accepts the resolve_geography slug ("us-pa"), postal ("PA"), or FIPS ("42") (EM-056). Defaults to the simulation's race_scope geography.
  • margin · number · optionnel
    plurality: win by at least this many votes.
  • offset · integer · optionnel
    Page start; pass next.offset from the prior result with the same scope and filters.
  • context · string · optionnel
    Free-text constraints, echoed back (e.g. "field ops in Orange and Durham only").
  • goal_mode · string · optionnel · plurality | majority | share
    plurality = beat the leading opponent (default); majority = 50.01% share; share = explicit target_pct.
  • target_pct · number · optionnel
  • scenario_id · string · requis
    The scenario/simulation handle (EM-056: simulation_id is accepted as an alias).
  • candidate_id · string · optionnel
  • rolloff_rate · number · optionnel
    Explicit roll-off rate (see compute_vote_goal).
  • workspace_scope · string · optionnel
    Optional workspace for THIS call: use an exact personal/team ID from list_workspaces. Repeat on each call; it does not change the connection default. Must agree with MCP metadata and the effective HTTP workspace selector (header, otherwise connector URL). OAuth connections can only use their granted workspace. Membership and campaign permissions still apply.

  Exemple d'appel

  {"name": "target_precincts", "arguments": {"scenario_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://www.electionsmcp.com/mcp