
Us Race Matchups
Who holds each US House or Senate seat, who is running and the money behind them
- Pricing
- Freemium
- Platforms
- API
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- 3 days ago
About Us Race Matchups
Us Race Matchups is a freemium MCP server for legal and government. It can run locally on your machine or as a hosted remote server.
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.
Install
Run in a terminal
claude mcp add --transport http us-race-matchups https://gateway.pipeworx.io/us-race-matchups/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/us-race-matchups/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"us-race-matchups": {
"url": "https://gateway.pipeworx.io/us-race-matchups/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"us-race-matchups": {
"type": "http",
"url": "https://gateway.pipeworx.io/us-race-matchups/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"us-race-matchups": {
"serverUrl": "https://gateway.pipeworx.io/us-race-matchups/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"us-race-matchups": {
"type": "http",
"url": "https://gateway.pipeworx.io/us-race-matchups/mcp"
}
}
}Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Freemium, from $49 a month
Free tier: 50 calls a day anonymous, 200 with a free account; paid plans from $49/month or pay as you go
Prices change. Check pipeworx.io before you buy.
Us Race Matchups 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 to Us Race Matchups

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data

NY LLC Publication (FileMyPublication)
MCP serverNew York LLC publication rules, deadline, county prices, clerks and notice text
- 8 tools
- Remote
- Free
- Legal and government