How to Use the vote.direct MCP in Pydantic AI

Q: What if I need to confirm election status using Pydantic AI?

You'll call checkapistatus. The Pydantic validation ensures the response structure is clean and predictable. It confirms operational status without risk of unexpected data fields.

Q: How do I find voter deadlines using vote.direct with Pydantic AI?

Use getregistrationdetails. This tool gives you state-specific deadlines and links, all of which are validated by Pydantic to ensure correct data typing for your agent.

Q: Can I find ballot info for a specific address with vote.direct using Pydantic AI?

Yes, getballotinformation requires an election and address. The response is guaranteed to be type-safe, which is essential when handling sensitive voter details.

Q: What if I need to check for future elections using Pydantic AI?

The getupcomingelections tool takes a ZIP code and returns election data. The Pydantic validation step confirms that every field—from the start date to the election name—is correctly formatted.

Validate election data using your Pydantic AI framework.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect vote.direct MCP to Pydantic AI

Create your Vinkius account to connect vote.direct to Pydantic AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup vote.direct with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get voter ballot information with the MCP Server

Use `get_ballot_information` to retrieve full ballot details, passing in an election and address. Because of runtime validation, if the API response structure is wrong, your agent fails loudly—you'll never get corrupted data. This strict type checking ensures that when your Pydantic-AI agent receives voter records, they conform exactly to the schema you defined.

Identify upcoming elections using MCP Server

Need election scope? `get_upcoming_elections` accepts a ZIP code and returns structured data on scheduled events. The Pydantic validation guarantees that the list of dates, names, and locations is perfectly typed. This makes your agent reliable; you'll know immediately if the API output deviates from expected structure.

Verify polling sites with the MCP Server

The `get_polling_locations` tool accepts an address and returns nearby voting sites. Crucially, Pydantic validates that every returned location field (like street or county) matches the expected data type. This prevents silent failures where a bad API response might include text in a numerical field.

Setup guide

Set up vote.direct MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "votedirect-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to vote.direct tools.",
)

result = await agent.run("List recent vote.direct transactions")
print(result.output)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by vote.direct. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect vote.direct now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about vote.direct MCP in Pydantic AI

You'll call `check_api_status`. The Pydantic validation ensures the response structure is clean and predictable. It confirms operational status without risk of unexpected data fields.

This server handles voter registration details, election addresses, and ballot information. Since the data is validated against a strict schema, you're guaranteed that the returned fields match your expected types.

Use `get_registration_details`. This tool gives you state-specific deadlines and links, all of which are validated by Pydantic to ensure correct data typing for your agent.

Yes, `get_ballot_information` requires an election and address. The response is guaranteed to be type-safe, which is essential when handling sensitive voter details.

The `get_upcoming_elections` tool takes a ZIP code and returns election data. The Pydantic validation step confirms that every field—from the start date to the election name—is correctly formatted.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript