Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use BallotReady with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Civic data and election information. track upcoming elections, candidates, and districts via AI.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 10 capabilities

The complete BallotReady capability set.

These are the exact actions your AI can choose when you ask it to work with BallotReady.

Capability set01 / 03

01-04

4 capabilities in this set.

Part of 10 available through BallotReady.

  1. 01

    Get districts by address

    Convenience capability to get districts by address

  2. 02

    Get elections by address

    Convenience capability to get elections by address

  3. 03

    List candidates

    List candidates running for office

  4. 04

    List districts

    Match an address to specific voting districts

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through BallotReady.

  1. 05

    List elections

    Find upcoming elections based on a specific address

  2. 06

    Get account check

    Verify BallotReady connection

  3. 07

    Get officeholders

    Retrieve current officeholders for districts

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through BallotReady.

  1. 08

    Get ballot measures

    Retrieve ballot measures for a specific election

  2. 09

    List positions

    List specific offices up for election

  3. 10

    Get candidate

    Get detailed profile for a specific candidate

Observed, not estimated

853ms average. Fast in production.

BallotReady is checked daily against the live service.

Daily averagePeak 1114ms
Aug 24Today
Fastest day
738ms
Slowest day
1114ms
14-day trend
Improving-19%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of BallotReady, so you can see the experience inside your AI.

It does not authenticate your account with BallotReady. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

BallotReady Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_cIZlsl7VFaYreLU3KJOVKmMhr83ZAoSfERCBdRHr/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — BallotReady capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "ballotready-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_cIZlsl7VFaYreLU3KJOVKmMhr83ZAoSfERCBdRHr/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions BallotReady owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.

Explore

More in Productivity

Suggestions