Election Index

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Neutral, sourced election calendar: polling days, when provisional and final results are due.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Election Index": {
      "url": "https://electionindex.org/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• next_election read-only

  The next elections in one country, however far ahead: polling day and whether it is declared, still tentative, or only expected within a period, what is elected, the counting authority, and when results are expected. Answers "When is the next election in Austria?" or "When are the US midterms?". National elections by default; level "regional" answers "When are the next state elections in Germany?". Covers 390 elections in 100 countries, 2021–2030, including 23 of the 27 EU member states, the 2026 US midterms in all 50 states and the certified 2024 US presidential result, with vote counts, in all 50 states and DC.

  Parameters:

  • country (required) — string — Country name or ISO 3166-1 alpha-2 code, e.g. "Austria" or "AT", "United States" or "US"
  • count — integer — How many upcoming elections to return, soonest first; default 3
  • level — string — national: the country votes; regional: a state, region or autonomous community elects its own parliament or head (German Länder, Spanish autonomous communities, Italian regions). Default national; the answer also counts upcoming regional elections

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• upcoming_elections read-only

  List elections by date range and/or country, soonest first, with each race's expected count stage right now. Answers "Which elections are in Europe this autumn?", "Which elections are this month?" or "What elections does Germany have coming up?". Without dates it starts today; with a country and no end date it covers every future election of that country, otherwise the next 365 days. Covers 390 elections in 100 countries, 2021–2030, including 23 of the 27 EU member states, the 2026 US midterms in all 50 states and the certified 2024 US presidential result, with vote counts, in all 50 states and DC.

  Parameters:

  • to — string — End date YYYY-MM-DD; default +365 days, or no end when a country is given
  • from — string — Start date YYYY-MM-DD; default today
  • level — string — national: the country votes; regional: a state, region or autonomous community elects its own parliament or head (German Länder, Spanish autonomous communities, Italian regions). Default all
  • limit — integer — Most elections to return, soonest first; default 25, max 200. Narrow with from/to or country for more.
  • country — string — Country name or ISO 3166-1 alpha-2 code, e.g. "Austria" or "AT", "United States" or "US"
  • include_discovered — boolean — Also list elections found on Wikidata but not yet verified by Global Election Index

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• poll_blackout read-only

  Whether a country bans publishing opinion polls before a vote, checked now: verdict ban / no-ban / exit-polls-only / unverified, when a ban starts and ends (polls close), whether it is in force, the law and article, and the official text it was read in. Answers "Can I publish a poll in Spain this week?" or "When does the poll blackout end in Serbia?". Give an election id, or a country for its next vote. "unverified" means we hold no verified rule: it is not a finding that polls are allowed. Not legal advice.

  Parameters:

  • country — string — Country name or ISO 3166-1 alpha-2 code, e.g. "Austria" or "AT", "United States" or "US"; answers for its next election
  • election — string — Election id, e.g. "spain-general-2026"

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• pollster read-only

  A pollster's final published poll before each election we hold a certified result for, set against that result: share per party or candidate, error in points, mean absolute error, and the error on the winner's margin. Figures come from the pollster's own release or a registry, never an aggregator. Measured facts, not grades: nothing is ranked. Answers "How accurate was Novus in Sweden 2026?". Give a pollster id or name.

  Parameters:

  • pollster (required) — string — Pollster id or name, e.g. "novus" or "Verian"

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• election_status read-only

  Full record of one election: races, polls-close times, every count stage window (exit poll, election night, intermediate count, final result, government) with confidence and citation, the authority, sources, recorded vote counts, whether the record is stale, whether a poll-publication ban (poll_blackout) applies now, and when the exit poll is expected (exit_poll).

  Parameters:

  • election (required) — string — Election id, e.g. "latvia-parliamentary-2026"

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• when_final read-only

  When will a race's final (certified) result exist? Returns the expected window, its confidence (announced / precedent / estimate) and basis, how many days the final took last time, and the final count itself once we hold it. Use this before asking or settling any "final result" question.

  Parameters:

  • election (required) — string — Election id, e.g. "brazil-general-2026"; list ids with upcoming_elections
  • race — string — Race id, e.g. "president"; optional when the election has one race

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• check_question read-only

  Is a question about a given count stage answerable at a given time? Returns verdict ok / too-early / inside-window / too-late, settle_after, and the resolvable sources. Built to stop questions that read the provisional count when they mean the final one.

  Parameters:

  • election (required) — string — Election id, e.g. "brazil-general-2026"; list ids with upcoming_elections
  • race — string — Race id, e.g. "president"; optional when the election has one race
  • stage — string — Default final-result
  • ask_at — string — ISO date-time; default now

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• resolution_sources read-only

  Every known source URL for a race, classified (race_results, feed, results_index, emb_home, directory, media). Only race_results and feed can answer a results question; homepages never can. A results page whose HTML shows no count once one is due (figures_in_html false) is not resolvable. Sources a settlement oracle has answered from come first (oracle_reads). For our own copy of the count, see secondary_source in check_question.

  Parameters:

  • election (required) — string — Election id, e.g. "brazil-general-2026"; list ids with upcoming_elections
  • race — string — Race id, e.g. "president"; optional when the election has one race
  • resolvable_only — boolean — Only sources that can answer a results question (race_results, feed); default false

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• submit_correction

  Report a mistake or a missing election, with a URL that proves it (ideally the official authority page). The report is public and is checked like any other claim; it never changes the data by itself. Returns the report id; follow it at https://electionindex.org/corrections.

  Parameters:

  • claim (required) — string — What is wrong and what is right, 10 to 2000 characters
  • evidence (required) — string — http(s) URL of the page that proves it
  • race — string — Race id within that election, if the report is about one race
  • election — string — Election id, if the report is about a listed election

  Hints: read-only no · destructive no · idempotent no · open-world no

• dataset_health read-only

  Coverage, stale records, races still lacking a results page, and publisher-gate warnings, as counts with the first 20 of each (full report at /v1/health). Use to judge how far to trust an answer.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.