# Us Race Matchups

> Us Race Matchups is a freemium MCP server for legal and government. Who holds each US House or Senate seat, who is running and the money behind them. 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
- **Website:** https://pipeworx.io/packs/us-race-matchups
- **Repository:** https://github.com/pipeworx-io/mcp-us-race-matchups
- **MCP Registry name:** io.github.pipeworx-io/us-race-matchups
- **Categories:** legal and government, analytics and data
- **Listing updated:** 2026-11-14

## About

Each federal race comes back as one record: the sitting officeholder, every FEC-registered candidate by party, and the primary, runoff and general election dates. Candidate entries carry total receipts, disbursements, cash on hand, the date their money data runs through, and a won_primary field. It is built for the 2026 midterms, with the general election on 3 November 2026, but works for any even-numbered cycle.

The README is careful about caveats. won_primary is inferred by matching surname and party because the primary tables carry no FEC IDs, and it is null when two filers cannot be told apart. Primary vote counts come from volunteer-compiled Wikipedia pages, labelled as not official. The incumbent is the sitting officeholder, so read seeking_reelection to see whether they are on the ballot. Candidates with no financial summary show null money, not zero.

A second tool lists every race in a state so you can find a district number. No home addresses or personal contact details are served.

## Features

- **One-call race view:** Returns incumbent, candidates, money and election dates for a House district or Senate seat.
- **Candidate finance:** Shows receipts, disbursements and cash on hand per FEC filer.
- **Primary results:** Includes primary vote tables and an inferred won_primary flag.
- **Open seat clarity:** seeking_reelection and incumbent_note say whether the incumbent is actually running.
- **State race list:** Lists each race in a state with candidate counts and incumbents.
- **Special elections:** A special flag reads the special Senate election pages, as in Ohio and Florida in 2026.

## Good for

- Brief a reporter on a House district's candidates and money
- Find which races in a state have no incumbent running
- Compare cash on hand across a Senate field
- Look up a district number before pulling a full race

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `race_matchup`: Returns one US House district or Senate seat with incumbent, candidates, finances, primary results and election dates.
- `list_races`: Lists every race in a state with candidate counts and incumbents.

## FAQ

### Is the primary result data official?

No. It comes from Wikipedia, which the README labels volunteer-compiled, and each response names the relevant state election authority.

### How is won_primary decided?

It is inferred by matching surname and party, and is null when two filers cannot be told apart.

### Do I need a key?

No. Callers pass nothing, since the gateway holds the shared data.gov key.

### Does it serve candidate home addresses?

No. No home addresses or other individual contact details are served.

### Is Us Race Matchups free?

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

### How do I add Us Race Matchups to Claude Code?

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

### What are the best alternatives to Us Race Matchups?

The closest alternatives to Us Race Matchups 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-race-matchups
