How to Use the Bitquery (Web3 Blockchain GraphQL APIs) MCP in OpenAI Agents SDK

Fetch raw blockchain data from 40+ chains directly inside your OpenAI Agents SDK workflows with this secure 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 Bitquery (Web3 Blockchain GraphQL APIs) MCP to OpenAI Agents SDK

Create your Vinkius account to connect Bitquery (Web3 Blockchain GraphQL APIs) 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 Bitquery (Web3 Blockchain GraphQL APIs) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Blockchain Streaming via OpenAI Agents SDK

`query_v2` executes GraphQL queries against the Bitquery V2 Streaming API to grab real-time ledger data. Your agent pulls on-chain transfers, DEX trades, or smart contract events on Solana and Ethereum by calling this tool directly. Because this MCP Server integrates with the OpenAI framework, you pass the server endpoint, and the agent constructs the GraphQL payload itself. You get instant updates on balance shifts or token swaps without writing boilerplate query builders.

Historical Chain Analytics for Autonomous Agents

`query_v1` fetches older block data, historical token prices, and past transaction records across dozens of networks. This tool feeds your agent the exact historical context it needs to run deep financial analysis or audit wallets. The agent system handles the GraphQL execution behind the scenes. It maps the raw response data to its memory, letting you build agents that spot multi-year trends or trace ancient exploits automatically.

Secure Token Management in Production

`generate_token` creates an OAuth2 access token using your Client ID and Secret to authenticate every single request. This tool sets up the required BITQUERY_ACCESS_TOKEN credential so you don't have to hardcode keys in your agent configuration. You run this setup step once during the agent initialization phase. The OpenAI framework caches the tool definitions, ensuring your production runs remain authenticated and safe from credential leaks.

Setup guide

Set up Bitquery (Web3 Blockchain GraphQL APIs) 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 Bitquery (Web3 Blockchain GraphQL APIs) tools at runtime.
3

Create your Agent

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

Run the agent

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

Install the package and pass the server HTTP URL to MCPServerStreamableHttp. The framework automatically discovers the GraphQL tools and exposes them to your agent.

You can query over 40 blockchains, including Bitcoin, Solana, and Ethereum. The agent uses the same GraphQL interface to pull data from any of these networks.

Yes, the streaming API tools allow your agent to fetch live DEX trades and block events. It uses the V2 engine to get the freshest ledger state.

Yes, the agent generates queries that join calls, events, and transfers in a single request. This keeps your token usage low by avoiding multiple round trips.

Your credentials reside entirely in your local environment variables. The server handles token generation locally, meaning your private API keys never touch third-party servers.

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