How to Use the Clearout MCP in AutoGen

Q: How do AutoGen agents collaborate on a Clearout bulk verification?

One agent initiates the job with verifybulk, while another monitors getbulkstatus. They share updates in the group chat, allowing a third agent to download results once the check finishes.

Q: How do AutoGen agents handle low Clearout credits?

A budget agent calls getcredits and alerts the group chat if the balance is low. The agents then debate whether to proceed with smaller lists or pause the run until credits are added.

Q: What happens if I need to clear a list from the server?

Your agents can use removebulklist to delete the list from the remote server. They will only trigger this after confirming that all results have been successfully downloaded and logged.

Let your AutoGen agents debate list quality and verify emails using the Clearout MCP Server.

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 AutoGen

Create your Vinkius account to connect Clearout to AutoGen 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 AutoGen

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resolve lead quality disputes in AutoGen

The `verify_email` tool acts as the ultimate arbiter when your AutoGen agents debate lead quality. A sales agent might push a contact forward, but your compliance agent can trigger the verification tool to check if the address is valid. The agents negotiate based on the verification status returned. This consensus-driven workflow prevents your outbound campaigns from sending messages to dead mailboxes.

Coordinate bulk list validation via agent debate

The `verify_bulk` MCP tool allows a coordinator agent to process large batches of emails after gaining consensus from the group. A budget agent checks `get_credits` first, while a strategy agent monitors progress using `get_bulk_status`. If the budget agent flags high costs, it negotiates with the coordinator to run `cancel_bulk` and halt the run. The agents collaborate to process lists without burning through your API limits.

Find and verify target domains collectively

The `find_email` tool enables your research agent to discover prospect contacts and present them to the group. Before anyone writes a message, a validation agent uses `verify_catchall` to confirm the domain doesn't swallow mail silently. The agents discuss the risk profile of catch-all domains before finalizing the outreach plan. This multi-agent verification process guarantees that only high-deliverability targets make the final cut.

Setup guide

Set up Clearout MCP in AutoGen

Prerequisites

Python 3.10+ installed
autogen-ext[mcp] package
Active Vinkius subscription with a valid endpoint token

1

Install AutoGen with MCP
Run pip install "autogen-ext[mcp]" autogen-agentchat. The MCP extension includes mcp_server_tools for stateless tool access.
2

Fetch tools from the MCP
Call mcp_server_tools(SseServerParams(url=...)) with your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Run your agent
Pass the tools to AssistantAgent and call agent.run(). The agent invokes Clearout tools and returns structured results.

agent.py

from autogen_ext.tools.mcp import SseServerParams, mcp_server_tools
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

server_params = SseServerParams(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

tools = await mcp_server_tools(server_params)

agent = AssistantAgent(
    name="Clearout_assistant",
    model_client=OpenAIChatCompletionClient(model="gpt-4o"),
    tools=tools,
)

result = await agent.run("List recent Clearout data")
print(result.messages[-1].content)

Get your connection token →

Prerequisites

Python 3.10+ installed
autogen-ext[mcp] + autogen-agentchat
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Same packages as above. McpWorkbench is ideal when your agent needs stateful sessions across multiple tool calls.
2

Use McpWorkbench as context manager
Wrap your agent in async with McpWorkbench(...) to maintain shared state and resources. The workbench manages the full MCP session lifecycle.
3

Run with workbench
Pass workbench=workbench to your agent. State is preserved across multiple tool calls within the same session.

agent.py

from autogen_ext.tools.mcp import McpWorkbench, SseServerParams
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

server_params = SseServerParams(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

async with McpWorkbench(server_params) as workbench:
    agent = AssistantAgent(
        name="Clearout_assistant",
        model_client=OpenAIChatCompletionClient(model="gpt-4o"),
        workbench=workbench,
    )

    result = await agent.run("List recent Clearout data")
    print(result.messages[-1].content)

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 AutoGen

One agent initiates the job with `verify_bulk`, while another monitors `get_bulk_status`. They share updates in the group chat, allowing a third agent to download results once the check finishes.

Yes, you can configure a security agent to intercept calls to `verify_email`. It checks the target domain against a blacklist before allowing the MCP tool to execute.

A budget agent calls `get_credits` and alerts the group chat if the balance is low. The agents then debate whether to proceed with smaller lists or pause the run until credits are added.

Your agents can use `remove_bulk_list` to delete the list from the remote server. They will only trigger this after confirming that all results have been successfully downloaded and logged.

Yes, all lead details processed by this MCP Server are handled inside a secure, ephemeral V8 isolate sandbox. The data is never written to persistent disk or used for model training, keeping your customer lists private.

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