How to Use the Etherscan MCP in AutoGen

Q: How do I register the Etherscan MCP Server tools with my AutoGen agents?

Install autogen-extmcp and use the MCP tool helper with your Vinkius HTTP transport URL to connect to Etherscan. Pass the resulting tool list directly into your AutoGen AssistantAgent constructor to give your agents access to the Ethereum ledger.

Q: Can AutoGen agents collaborate to track ERC-20 transfers via Etherscan?

Yes, one AutoGen agent can call the Etherscan gettokentx tool to pull raw transfer data, while a tracking agent analyzes the sender and receiver addresses. They exchange messages within AutoGen to map out the flow of Ethereum funds and flag suspicious transfer patterns.

Let AutoGen agents debate Ethereum transaction histories, gas costs, and smart contract safety using real-time Etherscan data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Etherscan MCP to AutoGen

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit contracts with AutoGen agents using Etherscan

The Etherscan MCP Server exposes `get_source_code` and `verify_source_code` to fuel multi-agent debates within your AutoGen framework. A dedicated AutoGen security agent pulls the contract code from Etherscan, while a separate audit agent identifies potential reentrancy bugs. These AutoGen agents argue over the Etherscan contract safety in a structured conversation loop, converging on a final risk score. You get a rigorous, multi-perspective Ethereum safety report before deploying any capital to a new protocol.

Negotiate gas optimization between AutoGen agents

The `get_gas_oracle` and `get_block_number` Etherscan tools provide live network metrics to coordinate execution timing across your AutoGen agent group. An AutoGen performance agent pushes for immediate transaction execution, while a cost-saving agent analyzes the Etherscan gas oracle to suggest waiting. They negotiate the optimal Ethereum gas price threshold based on current network congestion data from Etherscan. This consensus-driven AutoGen approach ensures your automated transactions execute at the lowest possible cost without getting stuck in the mempool.

Validate historical ledger data through AutoGen group chat

The `get_transaction_by_hash` and `get_logs` Etherscan tools allow your group of AutoGen agents to verify complex Ethereum transaction events before taking action. One AutoGen agent fetches the raw transaction payload from Etherscan, and another decodes the event logs to confirm execution. Because AutoGen allows agents to cross-examine each other's inputs, they catch Etherscan parsing discrepancies immediately. This prevents a single hallucinating model from misinterpreting raw Ethereum hex logs or executing incorrect follow-up actions.

Setup guide

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

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

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

Install `autogen-ext[mcp]` and use the MCP tool helper with your Vinkius HTTP transport URL to connect to Etherscan. Pass the resulting tool list directly into your AutoGen `AssistantAgent` constructor to give your agents access to the Ethereum ledger.

Yes, one AutoGen agent can call the Etherscan `get_token_tx` tool to pull raw transfer data, while a tracking agent analyzes the sender and receiver addresses. They exchange messages within AutoGen to map out the flow of Ethereum funds and flag suspicious transfer patterns.

The MCP adapter handles the schema conversion, but your AutoGen orchestration loop must manage execution frequency to avoid Etherscan rate limits. If a tool like `get_balance` hits a rate limit, the AutoGen agent receives the error directly and can debate whether to pause or retry.

Yes, any agent in the AutoGen group chat can invoke the Etherscan `get_abi` tool to fetch the interface for a specific contract. This allows the AutoGen group to dynamically construct valid Ethereum transaction payloads based on the verified ABI structure.

No, the Vinkius platform handles authentication securely at the gateway level, meaning your AutoGen agents never touch or expose your raw Etherscan API keys. All Ethereum transaction queries and address logs are processed within isolated, zero-trust runtimes.

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