How to Use the Clearout MCP in Pydantic AI

Q: What's the best way to check bulk job status with Clearout and Pydantic AI?

Call the getbulkstatus tool using the job's list ID. Pydantic AI will parse the response, giving your agent a typed object with the job's progress and status, so you can trust the data you're acting on.

Q: Can I remove a list I've uploaded for bulk verification?

Of course. The removebulklist tool lets you delete a list and its associated data from the Clearout system. This is useful for cleaning up after a job is complete.

Get type-safe, validated email verification results in your Pydantic AI agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Clearout MCP to Pydantic AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stop Bad Data Before It Starts

When your agent calls a tool like `find_email` or `verify_email`, Pydantic AI automatically parses the JSON response from the Clearout server. The result isn't a dictionary you have to guess at; it's a Pydantic model with defined types. If the server ever returns an unexpected field or the wrong data type, your code doesn't fail silently. Pydantic AI raises a `ValidationError` immediately. This means your agent will never operate on corrupted or misunderstood data from the API.

Run Bulk Verifications with Confidence

Start a large job by giving your list of emails to the `verify_bulk` tool. The tool returns a list ID, which Pydantic AI ensures is a properly formatted string. There's no room for error. Later, when your agent calls `get_bulk_status` to check on the job, the response—including the status string and completion percentage—is validated against a Pydantic model. You know for a fact you're getting the data structure you expect, every single time. This makes your downstream logic much simpler and more reliable.

Build Reliable Monitoring with Pydantic AI

Use this MCP server to build monitoring that can't fail due to schema drift. When your agent calls `get_credits`, the response is an object with a guaranteed `balance` field of type `int`. You don't need to write defensive code to check if the field exists or is a number. It's the same for `check_clearout_status`. The tool's response is parsed into a model, so your agent can reliably check the API's health. Pydantic AI's type safety means you can trust the data your monitoring agent gets back.

Setup guide

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

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

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

Pydantic AI automatically validates every response from the Clearout MCP server against a strict schema. If the API returns anything unexpected, your agent gets a validation error instead of bad data, protecting your application from bugs.

Yes. Pydantic AI is model-agnostic. You can connect to the Clearout server using agents powered by OpenAI, Anthropic, Gemini, or even a local model you're running yourself.

Call the `get_bulk_status` tool using the job's list ID. Pydantic AI will parse the response, giving your agent a typed object with the job's progress and status, so you can trust the data you're acting on.

Of course. The `remove_bulk_list` tool lets you delete a list and its associated data from the Clearout system. This is useful for cleaning up after a job is complete.

The server only ever receives the email addresses you submit for verification. Each request is handled inside a dedicated Vinkius sandbox that is destroyed after your request is complete. No data is stored or logged by the server.

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