pipeworx-io/mcp-us-elections

U.S. election results — candidate-level vote counts for President and U.S.
Senate by state (every state, 1976-2024); official FEC district-by-district
U.S. House results for the 2020 and 2022 general elections nationwide (the
ungated alternative to MEDSL's guestbook-gated House file); and county- (13
states) and precinct-level (Pennsylvania, Michigan) detail for President,
Senate and U.S. House in the 2024 general election. Fleet #2952, extended
fleet #2958.
Part of Pipeworx — an MCP gateway connecting AI agents to 1784+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.
Tools
- election_results(state, year, office, level?, county?, district?, limit?, offset?)
— candidate-level results for one state/year/office at state, county,
or precinct granularity (default county). Pass county to scope a
county- or precinct-level query to one county, or district (e.g. "09")
to scope a House race to one district. Each row carries candidate,
party, votes, the race total and vote share, plus source, source_url,
license and data_as_of. A combination with no data returns a loud
not-found naming which levels actually exist, never an empty success.
- election_race_summary(state, year, office) — aggregated totals, vote
share, winner and margin for a race, computed from the most aggregated
level actually available (statewide when covered, otherwise summed from
whatever county/precinct detail exists). A district office (House) returns
one summary per district.
- list_elections(state?) — the state/year/office combinations this pack
actually holds, and at which levels. Call this first to check coverage
before querying a specific race.
State accepts a postal code ("PA") or full name ("Pennsylvania"),
case-insensitive. Office accepts "president", "senate", or "house"
(and common synonyms like "POTUS", "U.S. Senate").
Auth
Keyless. The tools answer only through the Pipeworx gateway, which holds the
data; a standalone npm install has no data to read, and every tool throws
a clear "not bound in this runtime" error there instead of returning an
empty list.
Data sources
- MIT Election Data + Science Lab (MEDSL), Harvard Dataverse — state-level
U.S. President returns, 1976-2024.
- MIT Election Data + Science Lab (MEDSL), Harvard Dataverse — state-level
U.S. Senate returns, 1976-2024.
**Licence: CC0 1.0** (public domain dedication) for both.
- Federal Election Commission (fec.gov) — official "Federal Elections"
statistical publication: district-by-district U.S. House results, 2020 and
2022 general elections. (The same publication also has a Senate sheet,
deliberately not loaded here — MEDSL above already covers Senate
state-level for those years; loading both would double-count every
candidate under election_race_summary. See load-data.mjs.)
**Licence:** public domain (U.S. government work, 17 U.S.C. 105). No login,
key or guestbook — served as a plain xlsx download off fec.gov.
- OpenElections — county-level 2024 general-election returns for Georgia,
Mississippi, New Mexico, North Dakota, South Dakota, Tennessee, Utah, West
Virginia, Colorado, Missouri, Oregon, South Carolina and Kentucky (13
states), plus true precinct-level returns (also rolled up to county) for
Pennsylvania and Michigan.
**Licence:** no separate data-reuse licence is published on the data
repositories; the project's parser codebase (openelections-core) is MIT,
and the underlying figures are county/state election-board certified vote
counts — public election records. No terms were found forbidding reuse, so
this pack builds a copy per Pipeworx's rule for a source that only
publishes bulk files: build it, and flag it, when the terms are silent.
Known gaps — read before extending this pack