How to Use the Blockdaemon (Blockchain Infrastructure) MCP in OpenAI Agents SDK

Q: How do I connect the Blockdaemon (Blockchain Infrastructure) server to my OpenAI Agents SDK?

Install the SDK via pip and initialize the server using MCPServerStreamableHttp with your Vinkius endpoint. Pass this instance in the mcpservers list when creating your Agent. Enabling tool caching keeps startup times fast.

Q: What is the best way to handle agent handoffs when querying transaction lists?

You can design a router agent that calls listtransactions and then hands off the raw ledger data to a specialized financial analyst agent. The SDK manages this transition smoothly while maintaining context.

Query Blockdaemon blockchain infrastructure with OpenAI Agents SDK to feed production-grade ledger data directly into your agentic loops.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Blockdaemon (Blockchain Infrastructure) MCP to OpenAI Agents SDK

Create your Vinkius account to connect Blockdaemon (Blockchain Infrastructure) to OpenAI Agents SDK 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 Blockdaemon (Blockchain Infrastructure) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get block records inside your OpenAI Agents SDK loop

Feed raw block data straight to your agents. This tool exposes `list_blocks` so your autonomous agents can monitor blockchain state changes without leaving the OpenAI orchestration environment. You can set up specialized agents that watch block heights and hand off tasks to other agents when specific transactions clear. By configuring the `MCPServerStreamableHttp` client, your agent automatically discovers how to query block sequences. It uses the Blockdaemon Ubiquity API behind the scenes, letting you build real-time monitoring workflows that run inside your production-grade OpenAI dashboard.

Track wallet activity using this secure MCP Server

To keep your production runs safe, the OpenAI Agents SDK validates actions before execution. When your agent calls `list_transactions` to analyze a wallet, the built-in guardrails ensure the address format is correct before hitting the Blockdaemon network. You get full tracing on the OpenAI dashboard for every transaction query. If an agent tries to pull a massive transaction history, your guardrails can intercept the request, keeping your API costs predictable and your runs stable.

Extract financial reports and UTXOs for agent analysis

Financial operations require precise balance tracking. Your agents use `get_financial_report` and `get_utxos` to assess address balances and unspent outputs across multiple chains. Pass the MCP server inside the `mcp_servers` list during agent initialization. The SDK registers these tools natively, allowing your financial analysis agents to run async queries and pass structured ledger data to your downstream reporting pipelines.

Setup guide

Set up Blockdaemon (Blockchain Infrastructure) MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Blockdaemon (Blockchain Infrastructure) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Blockdaemon (Blockchain Infrastructure) tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Blockdaemon (Blockchain Infrastructure) tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Blockdaemon (Blockchain Infrastructure) Agent",
            instructions="You have access to Blockdaemon (Blockchain Infrastructure) tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 Blockdaemon. 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 Blockdaemon (Blockchain Infrastructure) 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 Blockdaemon (Blockchain Infrastructure) MCP in OpenAI Agents SDK

Install the SDK via pip and initialize the server using `MCPServerStreamableHttp` with your Vinkius endpoint. Pass this instance in the `mcp_servers` list when creating your Agent. Enabling tool caching keeps startup times fast.

Yes. The SDK natively supports async context managers, allowing your agents to fetch block details and UTXOs concurrently. This prevents blocking your main execution thread during heavy blockchain data analysis.

The SDK automatically inspects the MCP Server endpoint at runtime to register the four available blockchain tools on the MCP server. Your agents immediately understand how and when to call them without manual schema definitions.

You can design a router agent that calls `list_transactions` and then hands off the raw ledger data to a specialized financial analyst agent. The SDK manages this transition smoothly while maintaining context.

Vinkius runs the MCP server in a secure, ephemeral V8 isolate sandbox. Only the targeted blockchain addresses and transaction queries pass through the endpoint, ensuring no private keys or sensitive credentials are ever exposed to the model.

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