Get a free registered project key, or use the existing anonymous v1 public beta. Cache responses, preserve source and coverage fields, and never represent the ballot-preview endpoint as an official complete ballot.
Use Election.org’s read-only MCP connection to find federal candidate filings, recorded officeholders, campaign-finance summaries, federal election dates, historical House and Senate results, and local government records. Every response keeps source links and coverage limits alongside the data.
Connect a compatible MCP client to https://election.org/api/mcp using Streamable HTTP. No Election.org account or API key is required. Directory availability depends on the directory’s review; this page does not mean a ChatGPT listing has been approved.
“Find Laura Friedman’s federal candidate record and reported campaign finances.”
“What does the record show for Pennsylvania’s 2024 Senate election?”
“Find Bethel Township Municipal Authority in Berks County, Pennsylvania.”
This is a public-record research connection, not a voting recommendation service or an election authority. It does not access private voter files, take political actions, or accept home addresses. FEC filings do not prove ballot qualification. Campaign finances do not establish personal net worth. Source dates may differ and local coverage remains incomplete.
Email jack@election.org with the tool name and the public record link. Do not send passwords, private conversations, home addresses, or voter information. For incorrect data, include the original public source so we can review the record.
Public-data connection usage terms
Use this read-only connection for lawful public-record research. Election.org is independent of government election authorities. Check the original authority before relying on deadlines, eligibility, ballot status, or other actionable election information. Records are provided with their stated coverage and source limitations, without a guarantee of completeness or uninterrupted availability.
Keep reporting periods, source references, and uncertainty with reused findings. Do not misrepresent a filing as a certified candidacy, a missing value as zero, or a campaign balance as personal wealth. Do not use this service to obtain private voter data or evade access restrictions. Avoid abusive traffic; narrow queries and respect service errors.
Election.org claims no exclusive ownership of public-domain facts. Original-source rights and restrictions remain applicable; these terms do not grant rights to third-party material or imply anyone’s endorsement. Attribution is suggested, not a required unqualified backlink. Read the privacy notice and methodology. Questions: jack@election.org.
Address-bearing endpoints return Cache-Control: private, no-store. Static public-record endpoints are cacheable and all API responses allow cross-origin GET requests.
Credit the data. Keep the evidence.
Every successful public-data JSON response includes suggested citation metadata. The chart endpoint keeps its original chart and metadata fields; OpenAPI, CSV, calendar files, and errors keep their own formats.
record_url is the canonical public page when exactly one record link is available. Collections expose record_urls; use the page for the record you actually cite. If no record page is supplied, record_url is null and credit_url points to these API docs. Citation links never include private address queries.
updated_at is a stated dataset update, or null when unspecified. verified_at is the latest stated source check—not proof every record is current. generated_at only says when the response was created. Keep source dates, coverage, and limitations beside the claim.
Read beyond the first page
The candidate, committee, office, historical-result and local-candidate endpoints return bounded pages. Follow links.next until it is absent; a successful first response is not the complete collection. Candidate responses keep federal filings and state-authority entries in separate arrays, with the same offset and limit applied to each. Do not add their match counts together or call them a certified ballot. Historical results must be read one year at a time; local nominees cover only the named cities. Keep source metadata with every page and restart if it changes. Other endpoints have their own documented pagination; never assume an unadvertised offset works.
Example credit for the Japan country page:
Cite this data Text or HTML
Place the credit beside the data on your own page. Keep the original sources and any relevant coverage limits.
Suggested credit. You may edit or qualify links; this is not an endorsement or a new license. Reuse guidance →
We suggest a visible “Data via Election.org” credit near reused data, plus the original source. HTML examples use rel="nofollow" by default. Publishers may edit the credit and choose link attributes appropriate to their context; no ranking-passing backlink is required.
Election.org claims no exclusive ownership of public-domain facts. Source-specific licenses, attribution duties, and legal restrictions still apply. These citation tools do not relicense upstream material, grant permission to use protected content, or imply that Election.org or a source endorses your work.
Address
GET/api/v1/address?address=90068
Geography plus the complete currently sourced office stack.
Official California statewide propositions or all eight Los Angeles City measures, including neutral Yes/No meanings, source fingerprints, draft status, and visible source anomalies.
California Supreme Court and Court of Appeal roster records with court membership, source-reported roles, explicit service-note status, and separate official ballot connections.
Permanent federal and state public-person IDs with current roles, federal term history, exact external identifiers, and explicit identity and coverage boundaries.
Source-backed 2026 local candidate layers for Los Angeles and San Diego. San Diego includes all eight official nominees, ballot order, occupational designations, candidate-submitted portraits and materials, disclosure links, SHA-256 fingerprints, and explicit source boundaries.
Exact campaign-published headings for all eight Los Angeles finalists, normalized into equal-topic contest comparisons with source fingerprints, retrieval dates, explicit gaps, and no Election.org score.
Sourced debate events, public full-recording coverage, neutral topic timestamps, separate City Clerk candidate videos and transcripts, and explicit candidate or contest media gaps.
Exact current campaign statements connected to archived and live observations, with archive time treated only as observed-by evidence and no generated flip-flop or consistency label.
Precise campaign commitments connected to dated public actions and official measures, with source fingerprints, explicit reporting boundaries, and no kept-or-broken grade.
The same eight sourced CV fields for all eight Los Angeles finalists, separating certified ballot designations from exact campaign biography excerpts and showing every gap.
All current campaign-reported endorsement records for the certified Los Angeles field, preserving source order and campaign labels while explicitly forbidding count-based rankings.
Address-matched office records, federal constitutional minimums, and official filing sources—plus the complete 14-office Los Angeles 2026 filing adapter when the locality matches. Never a legal eligibility determination.
The same eight questions for every connected candidate, with verified-response and recorded-invitation status, source boundaries, and no score or inferred refusal.
Federal committee registration and summary records. Follow links.next for every included record, up to 250 per request. Coverage is the included federal cycle—not every historical or state/local PAC.
Official disclosure agencies plus live California, New York, Washington, and Colorado contribution, expenditure, filer, and privacy-safe entity aggregates—with jurisdiction-specific correction semantics and every remaining gap explicit.
Official 2024–2026 House Clerk filing-index records, including direct PTR PDFs, exact source codes, ZIP fingerprints, and explicit transaction and interpretation boundaries.
Whole-document-validated House PTR transaction rows with filer, asset, source ticker, direction, dates, value label, owner code, filing status, PDF page, fingerprint, and visible image-only exclusions.
Official 2025 Census government-unit, school-system, and public-pension records; matched California counties and incorporated places include the source-reported 2026 local roster with per-role selection method left unstated.
Official 2024 presidential popular-vote and electoral-vote totals compiled by the FEC from state election offices, with candidate and state filters and no implied House or Senate coverage.
Keep the returned source and coverage context near downstream claims. FEC registration and filing data is not proof of ballot qualification. A ZIP is a postal geography and its center can fall in a different political district than another address in the same ZIP.
