How to Use the Blockchair (Universal Blockchain Search Engine & API) MCP in LangChain

Q: Can I trace the execution of Blockchair (Universal Blockchain Search Engine & API) tools within LangChain?

Yes, every call to Blockchair tools like gettransaction or getaddress is logged automatically in LangSmith. You can inspect the exact inputs, outputs, and latency of your blockchain queries within your LangChain workflow.

Q: How do I validate addresses before querying transaction history?

The LangChain agent calls validateaddress to confirm the format is correct for the specified chain. If valid, the chain proceeds to call getaddress to pull the UTXO set and balance.

Feed live multi-chain data directly into your LangChain reasoning loops to query blocks, transactions, and addresses in real time.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Blockchair (Universal Blockchain Search Engine & API) MCP to LangChain

Create your Vinkius account to connect Blockchair (Universal Blockchain Search Engine & API) to LangChain 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 Blockchair (Universal Blockchain Search Engine & API) with LangChain

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Filter on-chain data with this MCP Server

The `filter_blocks` and `filter_transactions` tools let your LangChain agent execute SQL-like queries to extract precise multi-chain data. Your ReAct agent analyzes Blockchair's block transaction counts or fee ranges, deciding on its next logical step based on actual on-chain parameters. LangSmith traces the inputs and outputs of these Blockchair filters as your LangChain agent runs multi-step pipelines. You see exactly how the agent refines its search queries before passing the filtered blocks to the next node in your LangGraph workflow.

Resolve HD wallets using this MCP Server

The `get_xpub` and `get_address` tools retrieve historical balances and UTXO sets across Bitcoin and Ethereum networks. Your LangChain agent calls these Blockchair tools to inspect entire HD wallets, feeding the raw balances directly into downstream financial analysis chains. Instead of hardcoding address lookups, the LangChain agent determines when to call these Blockchair tools based on the user's prompt. Every step of the address resolution is tracked in LangSmith, giving you full visibility into latency and token usage during wallet inspection.

Audit Ethereum contract calls in LangChain

The `get_contract_calls` and `get_erc20_token_address` tools expose internal smart contract transactions and token balances for specific addresses. Your LangChain agent invokes these Blockchair tools to parse complex EVM executions during automated portfolio audits. By linking these Blockchair tools inside your LangChain chains, the agent can check an address's ERC-20 holdings and immediately fetch the corresponding contract calls to explain anomalies. You get a clear, traceable execution path from raw smart contract data to the final natural language summary.

Setup guide

Set up Blockchair (Universal Blockchain Search Engine & API) MCP in LangChain

Prerequisites

Python 3.10+ installed
langchain-mcp-adapters + langgraph packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install langchain-mcp-adapters langgraph langchain-openai. The MCP adapters package converts MCP tools into native LangChain BaseTool objects.
2

Connect via HTTP transport
Use MultiServerMCPClient with "transport": "http" pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create a ReAct agent
Pass the discovered tools to create_react_agent() from LangGraph. The agent automatically routes Blockchair (Universal Blockchain Search Engine & API) tool calls through the MCP protocol.
4

Run with any LLM
Swap ChatOpenAI for ChatAnthropic, ChatGoogleGenerativeAI, or any LangChain-compatible model. The MCP tools work identically across all providers.

agent.py

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

async with MultiServerMCPClient({
    "blockchair-universal-blockchain-search-engine-api-mcp": {
        "transport": "http",
        "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
    }
}) as client:
    tools = client.get_tools()

    agent = create_react_agent(
        ChatOpenAI(model="gpt-4o"),
        tools,
    )
    result = await agent.ainvoke({
        "messages": "List recent Blockchair (Universal Blockchain Search Engine & API) transactions"
    })
    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 Blockchair. 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 Blockchair (Universal Blockchain Search Engine & API) 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 Blockchair (Universal Blockchain Search Engine & API) MCP in LangChain

You use the MultiServerMCPClient to load the Blockchair tools and pass them to your LangGraph agent. The LangChain agent uses tools like `filter_blocks` to query specific chains, routing the output directly into subsequent chain steps.

Yes, every call to Blockchair tools like `get_transaction` or `get_address` is logged automatically in LangSmith. You can inspect the exact inputs, outputs, and latency of your blockchain queries within your LangChain workflow.

You manage rate limits by configuring your LangGraph runtime to handle retries or backoff when the LangChain agent calls `get_blockchain_stats` or other Blockchair tools. The stateless MCP adapter passes the raw API responses directly to your agent's memory.

The LangChain agent calls `validate_address` to confirm the format is correct for the specified chain. If valid, the chain proceeds to call `get_address` to pull the UTXO set and balance.

All lookups for addresses and xpubs run through Vinkius's secure, isolated sandbox environment. Your queries and private keys are never logged or stored, ensuring your financial footprint remains confidential.

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