Connect Bitquery to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the get token transfers tool in Bitquery
Use the get dex trades tool in Bitquery
Use the get token holders tool in Bitquery
Use the get transactions tool in Bitquery
Use the get smart contract events tool in Bitquery
Use the get token balances tool in Bitquery
Supported Tools
get_token_transfers
Get Token Transfers
Retrieve token transfer data from EVM blockchains or Solana. Track ERC-20, ERC-721, ERC-1155, and SPL token movements with filters for token, sender, receiver, and time range.
Use this to monitor wallet activity, track specific token movements, or analyze transfer patterns.
get_dex_trades
Get DEX Trades
Retrieve decentralized exchange (DEX) trade data from EVM blockchains or Solana. Query historical and recent trades filtered by token pair, DEX protocol, time range, and network.
Supports major DEXs like Uniswap, PancakeSwap, Raydium, Jupiter, and more across Ethereum, BSC, Polygon, Arbitrum, Base, Solana, and other networks.
get_token_holders
Get Token Holders
Retrieve the top holders of a specific token on EVM blockchains or Solana. Returns current EVM holder rankings. Solana rankings cover net balance movements for tokens launched within the recent retention window.
Use this for token distribution analysis, identifying whales, or tracking holder concentrations.
get_transactions
Get Transactions
Retrieve blockchain transactions from EVM chains or Solana. Filter by sender address, receiver address, or time range.
Use this to audit wallet activity, monitor address transactions, or investigate specific blockchain activity.
get_smart_contract_events
Get Smart Contract Events
Retrieve decoded smart contract event logs from EVM blockchains. Bitquery automatically parses events using ABI data, returning structured event names and typed arguments.
Use this to monitor contract activity, track specific events like Transfer, Swap, Approval, or any custom event emitted by a contract.
get_token_balance
Get Token Balances
Retrieve token balances for a wallet address on EVM blockchains or Solana. Returns current EVM token balances and the latest recently active Solana token-account balances.
Use this to check portfolio holdings, verify wallet balances, or monitor address token positions.
get_token_price
Get Token Price
Retrieve token price and OHLC (Open, High, Low, Close) candle data from DEX trades. Returns aggregated price data for a token pair over specified time intervals.
Useful for charting, price analysis, and building trading dashboards. Supports EVM chains and Solana.
execute_query
Execute GraphQL Query
Execute a custom GraphQL query against the Bitquery API. Supports the full Bitquery GraphQL schema for querying blockchain data across 40+ networks.
Use this for advanced or custom queries not covered by the other tools. The query must be a valid Bitquery GraphQL query string.
Enable Bitquery in Metorial. In your Metorial portal, enable the Bitquery MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Bitquery tools.
Enable Bitquery in Metorial. In your Metorial portal, enable the Bitquery MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Bitquery tools.
Enable Bitquery in Metorial. In your Metorial portal, enable the Bitquery MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Bitquery tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Bitquery in Metorial. In your Metorial portal, enable the Bitquery MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Bitquery tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Bitquery in Metorial. In your Metorial portal, enable the Bitquery MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Bitquery tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Bitquery through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Bitquery and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Bitquery tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Query real-time and historical blockchain data across 40+ networks including Ethereum, Bitcoin, Solana, and Polygon using a unified GraphQL API. Retrieve DEX trades, token prices, OHLCV candle data, token transfers, wallet balances, NFT ownership and metadata, smart contract events and calls, mempool pending transactions, and liquidity pool data. Trace money flows across addresses and chains for compliance and forensic analysis using Coinpath®. Analyze token holder distributions, top holders, and distribution metrics.
Frequently asked questions
Common questions about connecting Bitquery to AI agents with Metorial.
How many tools does the Bitquery MCP server have?
The Bitquery MCP server exposes 8 tools, including Get Token Transfers, Get DEX Trades, Get Token Holders. Each one is governed and traced through Metorial.
Does the Bitquery MCP server support triggers?
Bitquery exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Bitquery MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Bitquery MCP server through the same Metorial URL.
How do I give only some teams access to Bitquery?
Use role-based access control to decide which teams, users, and agents can use Bitquery and which of its tools they can call.
Can I self-host the Bitquery MCP server?
Yes. Metorial is open source, so you can run the Bitquery MCP server yourself or use the hosted gateway.
Connect Bitquery to production AI agents
See how Metorial gives your team governed access to Bitquery, with tracing and security controls built in.