• ROSTER
  • FILTER
  • SUMMARY
  • HUMAN

How to list election candidates with your AI

Connect the AP Elections API to your agent. Once linked, your AI can identify every candidate running in a specific election cycle or on a given date.

Ask AI about this page

Short answer

How can I find all candidates in an election using AI?

Your agent uses the list_election_candidates tool to pull names and details for any election cycle or date you specify. You'll get a structured list of everyone on the ballot. Here is how that data is handled.

The results you get

Where the data lands

The API provides the raw candidate information, and your AI organizes it into these formats.

ROSTER

Complete candidate lists

The AI pulls every person participating in your chosen cycle. You get a clean roster of names and their specific roles.

FILTER

Targeted election searches

Your agent can narrow down the results by specific dates or election types. This keeps the list relevant to the exact race you need.

SUMMARY

Organized candidate data

The AI turns the raw API response into a readable format. You can view the candidates in a list or a structured table.

HUMAN

Final verification

You must check the final list against official sources. The AI provides the data, but you handle the final validation.

The workflow

What your AI does when the request arrives.

The AI handles the data retrieval and organization so you don't have to manually search through election records.

  1. Identify the target

    Your agent parses your request to find the specific election cycle or date you're asking about.

    list_election_candidates

  2. Fetch the candidates

    The AI calls the API to pull the names and details of every person running in that window.

    list_election_candidates

  3. Format the list

    The agent takes the raw data and structures it into a clean, readable format for you.

    list_election_candidates

  4. Apply filters

    You can tell your agent to sort the results by party, office, or name.

    list_election_candidates

Try it

Copy these to start.

Paste these into your chat to get moving.

Starting points

Replace the bracketed text with the specific election or date you want to look up.

AP Elections API Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_ErnvmclTpJOBVwbKuP5EHbMHyfPWLqw3gKLX2VWQ/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 — AP Elections API capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "ap-elections-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_ErnvmclTpJOBVwbKuP5EHbMHyfPWLqw3gKLX2VWQ/mcp"
    }
  }
}
Copy into chat04

  • List all candidates participating in the 2024 General Election.

  • Who is running in the upcoming primary election on March 5th?

  • Show me a list of all candidates for the Senate in the current cycle.

  • Find all candidates running for local office in the November election.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect AP Elections API once, then ask.

Connect the MCP to your client with one click. Your login stays encrypted on our side, and you can start asking questions immediately.

Connect AP Elections API to your AI

FAQ

How this task behaves

  • 01

    Can the AI add new candidates to the list?

    No. The tool only reads existing data from the API. It cannot modify election records.

  • 02

    Does the AI provide candidate biographies?

    The tool provides names and participation details. It does not pull full personal biographies unless that data is included in the standard election record.

  • 03

    Can I search for candidates by their political party?

    Yes. Once the AI pulls the list, you can ask it to group or filter the candidates by party.

  • 04

    Will the AI update the list automatically when a new candidate enters a race?

    No. You have to ask your agent to run the tool again to get the most recent data from the API.

  • 05

    Can the AI vote or submit official election filings?

    No. This tool is only for retrieving information. It has no way to interact with government voting or filing systems.

  • More questions about AP Elections API? The Connector page answers them. See everything the AP Elections API Connector can do

Connect AP Elections API to Claude, Cursor, ChatGPT & more