@elections/mcp
v0.7.0
Published
MCP server for U.S. election data — the 2026 midterm slate, candidates, ballot measures, districts and official live results for all 50 states, D.C. and Congress, alongside the bills and roll-call votes those candidates are running on.
Maintainers
Readme
@elections/mcp
An MCP server that gives AI assistants real U.S. election data: the 2026 midterm slate, candidates with FEC and Bioguide crosswalks, statewide ballot measures with full text, electoral districts with GeoJSON boundaries, and official live results as they are reported — for all 50 states, D.C. and the federal Congress.
It also carries the legislative half of the same corpus: the bills, sponsors and roll-call votes that sitting legislators are running on — one server, one key, so an election question and a voting-record question do not need two vendors.
This is the same server published as
@legislation/mcp, under an
election-facing name. Installing either gives you the same 35 tools. Elections
and legislation are one dataset, so there is one server, one tool list and one
API key rather than two that cannot see each other.
Never a race call
The election tools report counts, percent reporting, and who currently leads. They do not call races, project winners, or forecast. Results come from official state election offices and the FEC.
Remote hosted server (recommended)
Nothing to install — point your client at https://mcp.delilahusa.com. It works
without a key on a shared, rate-limited free tier.
Claude — Settings → Connectors → Add custom connector:
https://mcp.delilahusa.com/Claude Code — a plugin that adds the server plus /elections and
/legislation skills:
/plugin marketplace add https://mcp.delilahusa.com/marketplace.json
/plugin install legislation@legislationCursor — ~/.cursor/mcp.json:
{
"mcpServers": {
"elections": {
"url": "https://mcp.delilahusa.com/",
"headers": { "Authorization": "Bearer dk_live_YOURKEY" }
}
}
}Local install (stdio)
One command, nothing to configure:
claude mcp add elections -- npx @elections/mcpWith no key it runs on the shared free tier: the hosted server supplies a key of its own, so tools work immediately. That tier is read-only and rate-limited per client. For your own monthly cap, request a key at https://delilahusa.com/developers/request and pass it through:
claude mcp add elections -e DELILAH_API_KEY=dk_live_… -- npx @elections/mcpElection tools
| Tool | What it does |
| --- | --- |
| get_midterms | The 2026-11-03 slate: races, contests, candidates and ballot measures per state, with official live results where reported |
| get_ballot_measure | Statewide measures for a state, or one measure by number with full text, summary and official source URL |
| list_candidates | The candidate directory, filterable by state, office and cycle, with FEC and Bioguide ids where available |
| get_candidate | One candidate's party, office, district and cycle, with an FEC filer id where the campaign has filed |
| list_districts | District metadata by state and type, with boundaries as GeoJSON on request |
Thirty more tools cover bills, bill text and diffs, legislators and scorecards, roll calls with individual member positions, committees, hearings, session analytics, a change feed and per-state coverage. See the full tool list.
Docs
- Setup for every client: https://delilahusa.com/docs/ai-tooling
- API reference: https://delilahusa.com/docs
MIT © Delilah Tech, Inc.
