How to Use the Hunter MCP in Pydantic AI

Q: How do I find specific emails using Hunter and Pydantic AI?

Your agent calls the emailfinder tool with a person's name and domain. The returned payload is validated against a typed schema, giving your agent immediate access to a verified email address.

Validate every lead, domain search, and verified email address at runtime using Pydantic AI and Hunter.

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 domain lookups with Pydantic AI

The `domain_search` tool retrieves professional email addresses associated with a specific company name or website domain. Because Pydantic AI validates every response, you can guarantee the returned data strictly matches your schema. If the search returns unexpected formatting, the runtime catches it before it corrupts your backend databases. This ensures your lead pipelines remain clean and predictable.

Strict verification via this MCP Server

The `email_verifier` tool analyzes a target address to confirm its deliverability status and server configuration. Your agent uses this tool to filter out catch-all addresses and invalid mailboxes before saving them. By validating the tool's output against strict Pydantic models, you prevent silent failures. Your code will raise an explicit error if a verification response is malformed.

Structured lead list management

The `list_leads` tool returns a structured list of your saved prospects and their custom attributes. Your agent can parse these records to match existing leads against new inbound signups. Pairing this with `list_lead_lists` lets your agent organize prospects into specific categories automatically. This keeps your outreach segmented and highly targeted without manual sorting.

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-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.io. 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

You initialize the MCPToolset class with your Vinkius HTTP endpoint. Then, pass the toolset instance into the toolsets list of your Pydantic AI Agent. The agent instantly gains type-safe access to all ten tools.

Yes, because Pydantic AI enforces strict runtime validation. If the API returns an error or unexpected data, your agent raises a clear validation error rather than guessing or hallucinating a response.

Your agent calls the `email_finder` tool with a person's name and domain. The returned payload is validated against a typed schema, giving your agent immediate access to a verified email address.

Yes, the integration runs natively inside Python's async event loops. You can run multiple lookups and verifications concurrently to process large batches of leads quickly.

All contact lists and email profiles are processed inside an ephemeral, zero-trust sandbox environment. Vinkius handles the API authentication securely, ensuring your raw API keys and lead data are never exposed or logged.

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