How to Use the Hunter MCP in Pydantic AI

Q: How do I register the Hunter MCP Server in Pydantic AI?

Install the slim package with mcp support and initialize MCPToolset with your Vinkius Hunter endpoint. Pass this toolset into your Pydantic AI Agent constructor to expose Hunter tools like searchdomainemails with runtime validation.

Q: How does Pydantic AI validate Hunter API credit usage?

Your Pydantic AI agent calls getaccountusage to fetch your remaining Hunter credit limits and parses the response into a typed model. This ensures your Pydantic AI script knows exactly when to pause before hitting Hunter billing caps.

Q: Can Pydantic AI handle bulk lead retrieval from Hunter?

Yes, your agent uses listsavedleads to pull active Hunter prospects and validates each profile against your Pydantic AI schema. You can then query getleaddetails for specific deep-dives on individual Hunter records.

Build type-safe email verification pipelines with Pydantic AI and the Hunter MCP integration.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Hunter MCP to Pydantic AI

Create your Vinkius account to connect Hunter 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 Hunter with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe email verification with Pydantic AI

The `verify_email_address` tool validates deliverability at runtime, forcing the response through strict Pydantic AI schemas. If Hunter returns unexpected formatting, your Pydantic AI application fails loudly instead of passing corrupted data downstream. This strict type checking ensures your Pydantic AI sales agents never send emails to syntactically invalid Hunter addresses. You get clean, validated Hunter responses that match your exact Pydantic AI data models.

Strictly structured domain searches

The `search_domain_emails` tool lets your Pydantic AI agent extract corporate Hunter emails while guaranteeing structural integrity. Your Pydantic AI agent maps the raw Hunter API response directly to your custom Python classes using the Vinkius MCP Server connection. By calling `get_domain_email_count` first, your Pydantic AI system validates the domain's size before running expensive Hunter lookups. This keeps your Hunter credit consumption predictable inside your Pydantic AI pipeline.

Reliable lead management and CRM sync

The `create_new_lead` tool saves verified prospects directly to your Hunter lists via the MCP connection with complete Pydantic AI schema safety. Your Pydantic AI agent uses `list_lead_folders` to find the correct Hunter folder, ensuring the lead details match your database fields. When Hunter updates are needed, your Pydantic AI agent calls `update_lead_info` to modify records without breaking data structures. If a Hunter lead is disqualified, your Pydantic AI agent cleanly executes `remove_lead`.

Setup guide

Set up Hunter 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": {
        "hunter-alternative-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

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

result = await agent.run("List recent Hunter 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 Hunter. 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 Hunter 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 Hunter MCP in Pydantic AI

Install the slim package with mcp support and initialize `MCPToolset` with your Vinkius Hunter endpoint. Pass this toolset into your Pydantic AI Agent constructor to expose Hunter tools like `search_domain_emails` with runtime validation.

Your Pydantic AI agent calls `get_account_usage` to fetch your remaining Hunter credit limits and parses the response into a typed model. This ensures your Pydantic AI script knows exactly when to pause before hitting Hunter billing caps.

Yes, your agent uses `list_saved_leads` to pull active Hunter prospects and validates each profile against your Pydantic AI schema. You can then query `get_lead_details` for specific deep-dives on individual Hunter records.

Your Pydantic AI agent will raise a validation error immediately if Hunter returns unexpected data, preventing silent corruption. This is ideal for production systems where Hunter data correctness is more important than speed.

Vinkius processes all Hunter API requests inside an ephemeral sandbox, exposing only the typed tools to Pydantic AI. Your Hunter keys are injected securely at the proxy level, so your local Pydantic AI agent never handles raw secrets.

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