How to Use the GetBlock (Web3 RPC Provider) MCP in OpenAI Agents SDK

Q: How do I connect GetBlock (Web3 RPC Provider) to OpenAI Agents SDK?

Install the package using pip, then instantiate MCPServerStreamableHttp with your Vinkius endpoint to connect the MCP Server. Pass this server instance directly into the Agent constructor's server list, and the SDK will automatically discover all 26 blockchain tools.

Q: Does this MCP Server support custom JSON-RPC methods?

Yes, you can use the rpccall tool to execute any arbitrary JSON-RPC method supported by GetBlock. This means if you need a specific method not covered by the standard toolset, your agent can still invoke it.

Build production-grade OpenAI Agents SDK systems that query multi-chain balances and submit raw transactions without managing nodes.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GetBlock (Web3 RPC Provider) MCP to OpenAI Agents SDK

Create your Vinkius account to connect GetBlock (Web3 RPC Provider) 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 GetBlock (Web3 RPC Provider) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Multi-Chain Balance Checks on OpenAI Agents SDK

Let your agents query wallet states across Bitcoin, Ethereum, and Solana without writing custom web3 integration code. By exposing tools like `eth_get_balance`, `sol_get_balance`, and `btc_getblockchaininfo`, your agent can inspect asset distributions on the fly. The OpenAI dashboard gives you a full trace of these calls, so you can see exactly when and why an agent decided to look up a wallet. You don't need to configure routing logic or maintain separate client libraries for each chain. The agent discovers these capabilities automatically, using the OpenAI platform's guardrails to validate that the requested wallet addresses match your application's safety parameters before executing the RPC request.

Broadcast Transactions Securely via MCP Server Tools

Moving assets requires precision, especially when agents are doing the heavy lifting. This MCP Server lets your agent build and broadcast raw transactions using `btc_createpsbt` and `sol_send_transaction`. Instead of giving the agent direct access to private keys, you handle the signing on your backend and let the agent submit the payload. The SDK's native handoffs allow a specialized transaction-drafting agent to pass the unsigned payload to a supervisor agent. Once approved, the supervisor invokes `btc_sendrawtransaction` or `eth_estimate_gas` to finalize the execution path.

Trace Smart Contracts Directly from Your Agent

When transactions fail, your agent needs to know why without you digging through explorer logs. It can call `debug_trace_transaction` or `debug_trace_call` to run dry-run simulations of EVM execution. This gives your agent the exact execution path to diagnose gas limits or reverted states. The agent can also pull raw block data using `eth_get_block_by_number` or inspect contract bytecode via `eth_get_code`. This lets you build developer-focused agents that can debug failing smart contracts in production.

Setup guide

Set up GetBlock (Web3 RPC Provider) 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 GetBlock (Web3 RPC Provider) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives GetBlock (Web3 RPC Provider) tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate GetBlock (Web3 RPC Provider) 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="GetBlock (Web3 RPC Provider) Agent",
            instructions="You have access to GetBlock (Web3 RPC Provider) 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 GetBlock. 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 GetBlock (Web3 RPC Provider) 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 GetBlock (Web3 RPC Provider) MCP in OpenAI Agents SDK

Install the package using pip, then instantiate `MCPServerStreamableHttp` with your Vinkius endpoint to connect the MCP Server. Pass this server instance directly into the `Agent` constructor's server list, and the SDK will automatically discover all 26 blockchain tools.

Yes, you can filter the tool list before passing it to the agent constructor. This is useful if you want to allow an agent to read data with `eth_get_balance` but prevent it from sending transactions using `sol_send_transaction`.

Vinkius manages the underlying connection and authentication with GetBlock. If your agent makes rapid calls like `eth_block_number` in a loop, the SDK handles the HTTP response codes, but you should set `cacheToolsList=True` to minimize setup overhead.

Yes, you can use the `rpc_call` tool to execute any arbitrary JSON-RPC method supported by GetBlock. This means if you need a specific method not covered by the standard toolset, your agent can still invoke it.

No private keys ever pass through this server. The MCP Server only processes public data like wallet addresses for `eth_get_balance` and pre-signed hex strings for `btc_sendrawtransaction`. Your keys remain safe in your own secure environment.

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