BallotReady Connector for AI agents.
10 live capabilities
Access nonpartisan election data and candidate profiles for any US address.
Waiting for input…
Why people use BallotReady
BallotReady Election Data for Nonpartisan Civic Research
BallotReady changes that by letting your agent do the digging for you. You just provide an address, and the agent pulls the candidates, districts, and ballot measures into one clean view. You get the facts without the friction.
What Vinkius changes
That it turns complex government data into a searchable, conversational knowledge base for your agent.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Fact-checking a local election
A journalist asks their agent to find all candidates running for State Senate in a specific county to verify a news story.
- Real-world use case 02
Explaining local ballots to seniors
A non-profit worker asks their agent to explain the upcoming ballot measures for a specific zip code.
- Real-world use case 03
Mapping a door-knocking route
A campaign team needs to know which voting districts cover a specific neighborhood.
Complete set · 10capabilities
The complete BallotReady capability set.
These are the exact actions your AI can choose when you ask it to work with BallotReady.
01—04
4 capabilities in this set.
Part of 10 available through BallotReady.
- 01 Capability
Get account check
Verify your BallotReady connection. This ensures your API key is active and the data flow is working correctly.
- 02 Capability
Get officeholders
Retrieve current officeholders for districts. Use this to see who currently holds power in a specific area.
- 03 Capability
Get districts by address
Get districts by address. This is a convenience capability to quickly map a physical location to its voting zones.
- 04 Capability
Get elections by address
Get elections by address. This quickly identifies all upcoming elections for a specific residential or commercial site.
05—07
3 capabilities in this set.
Part of 10 available through BallotReady.
- 05 Capability
List candidates
List candidates running for office. This provides a full roster of people on the ballot for a specific seat.
- 06 Capability
List districts
Match an address to specific voting districts. This capability helps you identify local representation for any location.
- 07 Capability
List elections
Find upcoming elections based on a specific address. This is the primary way to see what's happening on the ballot nearby.
08—10
3 capabilities in this set.
Part of 10 available through BallotReady.
- 08 Capability
Get ballot measures
Retrieve ballot measures for a specific election. Use this to see what specific votes are on the upcoming ballot.
- 09 Capability
List positions
List specific offices up for election. This helps you see exactly which seats are being contested in a district.
- 10 Capability
Get candidate
Get a detailed profile for a specific candidate. This provides bios and platform details in one request.
Set up in minutes
One URL. Then ask BallotReady to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use BallotReady from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_cIZlsl7VFaYreLU3KJOVKmMhr83ZAoSfERCBdRHr/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it BallotReady, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable BallotReady for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_cIZlsl7VFaYreLU3KJOVKmMhr83ZAoSfERCBdRHr/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the BallotReady URL.
- Step 03
Save and start
Save the connection and enable BallotReady in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"ballotready": {
"url": "https://edge.vinkius.com/vk_preview_cIZlsl7VFaYreLU3KJOVKmMhr83ZAoSfERCBdRHr/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using BallotReady
Open Agent mode in chat and ask: "Using BallotReady, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"ballotready": {
"url": "https://edge.vinkius.com/vk_preview_cIZlsl7VFaYreLU3KJOVKmMhr83ZAoSfERCBdRHr/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using BallotReady
Ask Copilot: "Using BallotReady, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"ballotready": {
"url": "https://edge.vinkius.com/vk_preview_cIZlsl7VFaYreLU3KJOVKmMhr83ZAoSfERCBdRHr/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using BallotReady
Open Cascade and ask: "Using BallotReady, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"ballotready": {
"url": "https://edge.vinkius.com/vk_preview_cIZlsl7VFaYreLU3KJOVKmMhr83ZAoSfERCBdRHr/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using BallotReady
Ask Cline: "Using BallotReady, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add ballotready --transport http "https://edge.vinkius.com/vk_preview_cIZlsl7VFaYreLU3KJOVKmMhr83ZAoSfERCBdRHr/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using BallotReady
Ask Claude: "Using BallotReady, show me...". 10 tools are ready
Where the request belongs
Work BallotReady can move forward.
This is for political researchers and civic organizers who are tired of manual data scraping. It is built for the person who needs to pull accurate candidate info for a newsletter or a non-profit trying to explain local laws to a neighborhood.
Political Researcher
Auditing candidate backgrounds and election schedules across multiple jurisdictions without manual searching.
Civic Organizer
Automating voter information retrieval for community outreach campaigns.
Journalist
Quickly retrieving accurate, nonpartisan election data for reporting and fact-checking.
Non-profit Coordinator
Building capabilities to help community members understand local ballots and representation.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsAP Elections API
Access real-time election results. audit races, candidates, and votes via AI.
Google Civic Information
Manage political data. audit representatives and elections via AI.
vote.direct
Manage voter info. audit polling locations, elections, and registration via IA.
OpenFEC (Federal Election Commission)
Access real-time federal campaign finance data. search candidates, track committee filings, and analyze election financial totals directly.
OpenStates
US state legislative data platform. track bills, legislators, and committees via AI.
LegiScan Legislation Lookup
Universal legislative intelligence. search bills, votes, and state laws via AI.
Bring your own AI
Change the model, client or framework. Keep BallotReady connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about BallotReady.
The practical details behind the request, access and result.
Can BallotReady MCP find elections for any US address?
Yes, it can identify upcoming local, state, and federal elections based on any specific physical address in the United States.
Does BallotReady MCP provide nonpartisan candidate info?
It provides nonpartisan profiles for candidates running for office, including their bios and key platform positions.
Can I use BallotReady MCP to see current officeholders?
Yes, you can use it to retrieve a list of the people currently holding office for specific voting districts.
How does BallotReady MCP help with ballot measures?
It allows your agent to pull and explain specific ballot measures and referendums for upcoming elections directly in your chat.
Is BallotReady MCP good for political research?
It is ideal for researchers who need to audit candidate backgrounds, election schedules, and district mappings across different jurisdictions quickly.
Can BallotReady MCP identify voting districts?
Yes, it can match a specific address to its corresponding voting districts so you know exactly how a location is represented.
Can I search for elections using just a city name?
For the highest accuracy, BallotReady capabilities like list_elections require a specific physical address (Street, City, State, ZIP). This ensures the agent returns the exact ballot measures and candidates for that specific location.
Does this integration provide information for international elections?
Currently, BallotReady focuses exclusively on comprehensive civic data within the United States, including local, state, and federal contests.
Can the agent tell me who my current representatives are?
Yes. Use the get_officeholders capability by providing a district ID (retrieved via list_districts for an address) to see a list of current leaders representing that area.
One connection away
Give your agent a direct line to BallotReady.
Connect BallotReady once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available