# Us Elections

> Us Elections is a freemium MCP server for analytics and data. Look up US election results by state, county, precinct and House district. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI
- **Website:** https://pipeworx.io/packs/us-elections
- **Repository:** https://github.com/pipeworx-io/mcp-us-elections
- **MCP Registry name:** io.github.pipeworx-io/us-elections
- **Categories:** analytics and data, legal and government
- **Listing updated:** 2026-11-15

## About

Coverage is uneven, and the README spells it out. President and Senate results come from MIT Election Data and Science Lab at state level for 1976 to 2024. District-by-district House results for the 2020 and 2022 general elections come from the FEC. County detail for the 2024 general election covers 13 states, and precinct detail covers Pennsylvania and Michigan.

Three tools handle it. list_elections tells you which state, year, office and level combinations exist, so call it first. election_results returns candidate rows with party, votes, race total and vote share, plus source, licence and data date. election_race_summary gives totals, winner and margin, summing from county or precinct data when no statewide row exists.

A request with no data returns an error naming the levels that do exist rather than an empty list. States accept postal codes or full names, and offices accept president, senate or house with common synonyms.

## Features

- **Candidate-level rows:** Votes, party, race total and share for a state, year and office.
- **Race summaries:** Totals, winner and margin, one summary per district for House races.
- **Coverage listing:** Shows which combinations and levels the pack holds.
- **Sourced results:** Each row carries source, source URL, licence and data date.
- **Clear not-found errors:** Missing combinations name the levels that do exist.

## Good for

- Compare state Senate results across years
- Pull county totals for a 2024 race
- Check House margins by district for 2020 or 2022
- Cite election data with its licence and source

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http us-elections https://gateway.pipeworx.io/us-elections/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/us-elections/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "us-elections": {
      "url": "https://gateway.pipeworx.io/us-elections/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "us-elections": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/us-elections/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "us-elections": {
      "serverUrl": "https://gateway.pipeworx.io/us-elections/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "us-elections": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/us-elections/mcp"
    }
  }
}
```

## Tools

- `election_results`: Candidate-level results for a state, year and office.
- `election_race_summary`: Totals, vote shares, winner and margin for a race.
- `list_elections`: State, year, office and level combinations held in the pack.

## FAQ

### Do I need an API key?

No. The registry says an optional Pipeworx key raises the daily cap; without one calls are anonymous and capped daily.

### How far back does it go?

State-level President and Senate returns run from 1976 to 2024.

### Is precinct data available?

The README lists precinct returns for Pennsylvania and Michigan in the 2024 general election.

### What licence covers the data?

The README gives CC0 for the MEDSL returns and public domain for the FEC House results.

### Is Us Elections free?

Us Elections has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Us Elections to Claude Code?

Run this command in your terminal: claude mcp add --transport http us-elections https://gateway.pipeworx.io/us-elections/mcp

### What are the best alternatives to Us Elections?

The closest alternatives to Us Elections are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/us-elections
