How to Use the Icypeas MCP in AutoGen

Q: Can I limit which AutoGen agent has access to my Icypeas campaign tools?

Yes, you can assign tools like listcampaigns exclusively to your campaign manager agent. This prevents researcher or writer agents from making unauthorized changes to your active outreach.

Q: How do I handle campaign list updates across multiple agents?

You can use listprospectlists to let your agents query active lists and coordinate updates. The agents chat to decide which list is the best fit for a newly discovered prospect.

Let your AutoGen agents debate and verify lead lists using Icypeas before launching your next outreach campaign.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Icypeas MCP to AutoGen

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-agent list validation using this MCP Server

`verify_email` acts as the referee in a multi-agent debate about lead quality and domain safety when using this MCP Server. A performance agent might push for high volume, but your safety agent can call this tool to veto risky domains. This team-based approach stops bad data from ruining your domain reputation. Your agents must reach a consensus on deliverability before any contact is approved for outreach.

Automated lead discovery via AutoGen agents

`find_email` allows your researcher agent to hunt down contact details based on company domains discussed during planning. Once found, the agent passes the email to a validator agent for instant double-checking. This division of labor keeps your pipeline clean without manual intervention. Your agents handle the search, validation, and list assignment dynamically through structured conversation.

Budget-conscious campaign management

`get_credits` is called by your controller agent to audit API spend before your researcher agent kicks off a massive search. If credits are low, the controller forces the team to prioritize high-value targets. This prevents automated runaways from burning your entire budget on low-intent lists. It keeps your multi-agent system operating strictly within your financial boundaries.

Setup guide

Set up Icypeas 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 Icypeas 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="Icypeas_assistant",
    model_client=OpenAIChatCompletionClient(model="gpt-4o"),
    tools=tools,
)

result = await agent.run("List recent Icypeas 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="Icypeas_assistant",
        model_client=OpenAIChatCompletionClient(model="gpt-4o"),
        workbench=workbench,
    )

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

Your agents use conversational consensus to decide when to call tools like search_prospects. One agent finds the prospects, another calls the verification tool, and a third registers them to a list.

Yes, you can assign tools like list_campaigns exclusively to your campaign manager agent. This prevents researcher or writer agents from making unauthorized changes to your active outreach.

Yes, the AutoGen MCP tool adapter translates the JSON schemas of tools like find_email directly into agent-compatible formats. This allows your agents to understand the required arguments without manual mapping.

You can use list_prospect_lists to let your agents query active lists and coordinate updates. The agents chat to decide which list is the best fit for a newly discovered prospect.

Your campaign records and prospect lists are protected via ephemeral local execution. Every call to get_campaign runs within an isolated environment, ensuring your proprietary sales lists are never exposed to external LLM providers.

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