Bitquery MCP Server

io.bitqueryPublished by bitquery.ioOfficial publisherv1.0.2Updated Nov 2, 2026

Hosted on-chain data for AI agents: DEX trades, OHLCV, top traders, fund tracing, address labels.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Hosted Bitquery MCP server giving assistants live on-chain data: DEX trades, OHLCV candles, trader PnL, fund tracing, address labels, Polymarket and…

What you can do
  • Query DEX trades, trending tokens, OHLCV candles, profitable or accumulating traders, wallet positions and decoded transaction swaps across many chains
  • Trace fund flows, screen addresses for risk, build address dossiers and expand related Bitcoin addresses
  • Explore Polymarket markets, odds, price history, trades, top traders and disputes (read-only)
  • Inspect Solana transfers, signatures, program instructions, new pump.fun launches and early buyers
  • Review Hyperliquid markets, open interest, funding rates, liquidations and trader positions
  • Run SQL over per-second DEX trade data on paid plans
When to use it
Useful when an assistant needs live crypto market or on-chain investigation data rather than static knowledge: token research, trader and wallet analysis, fund tracing, prediction-market or perp-market questions. It is a hosted service, so it suits clients that support remote HTTP MCP servers or can bridge through mcp-remote.
Requirements
A remote Streamable HTTP endpoint; nothing runs locally. A Bitquery account signed in through OAuth 2.1 in the browser on first use, with an Authorization bearer token sent by the client. A paid plan is needed for some tools, such as SQL over trade data, and credits are consumed per plan.
Before you install
Access is tied to a Bitquery account and its OAuth bearer token, and usage draws on monthly credits under a paid subscription (trial is 7 days). Tools are described as read-only for Polymarket, Solana and Hyperliquid, but queries still send wallet addresses and market questions to Bitquery's hosted service. Reported figures can be misleading: the README warns of counterfeit tokens and of profit rankings that omit open positions, so verify token addresses and positions before trusting results.

Installation

In SourceWeft

  1. Open Bitquery MCP Server in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.bitquery%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "bitquery": {
      "type": "http",
      "url": "https://mcp.bitquery.io/"
    }
  }
}

README

Bitquery MCP Server

By Gaurav Agrawal, Bitquery. Last updated 2 October 2026.

Official hosted Model Context Protocol server from Bitquery. It gives Claude, ChatGPT, Cursor, VS Code, Codex and other MCP clients live on-chain data: DEX trades, prices, candles, trader PnL, fund tracing and address labels.

  • Endpoint: https://mcp.bitquery.io
  • Transport: Streamable HTTP
  • Sign-in: OAuth 2.1 with your Bitquery account. No API key to paste and no config secrets.
  • Install: nothing runs on your machine. The server is hosted.

This repository holds the install configs, example prompts and docs. The server itself is a hosted service, so there is no code to build here.

Watch the 38-second demo: Polymarket and Hyperliquid data in ChatGPT and Claude.

[Video thumbnail: Polymarket and Hyperliquid data in ChatGPT and Claude with Bitquery MCP]

Install in 60 seconds

Claude Code

bash
claude mcp add --transport http bitquery https://mcp.bitquery.io

Add --scope user to enable it in every project. On first use run /mcp and finish the browser login.

Claude Desktop and claude.ai: Settings → Connectors → Add custom connector. Name Bitquery, URL https://mcp.bitquery.io. A browser window opens for login.

ChatGPT (Plus, Pro or Business): Settings → Connectors → Add connector → Custom connector. URL https://mcp.bitquery.io.

Cursor: Settings → MCP → Add new MCP server, or copy configs/cursor.mcp.json to .cursor/mcp.json.

VS Code: copy configs/vscode.mcp.json to .vscode/mcp.json.

OpenAI Codex CLI

bash
codex mcp add bitquery --url https://mcp.bitquery.io

or use configs/codex.config.toml.

Clients that only speak stdio bridge through mcp-remote: see configs/claude-desktop-stdio-bridge.json.

What you can ask

Trading and market data

DEX trades on Ethereum, Arbitrum, Base, Polygon, Optimism, BNB Chain, Tron, Solana, Robinhood Chain and Arc.

AskTool the agent picks
What are the trending Solana tokens in the last 24 hours by trade volume?trending_tokens
Show OHLCV candles for WETH/USDC on Uniswap v3 for the past 7 days.pair_ohlcv
Who are the most profitable traders of this token this month, and what do they hold now?profitable_traders_by_token, trader_positions
Which wallets are accumulating this token right now?accumulating_traders_by_token
Decode this transaction: every swap inside it, with amounts, price and pool.tx_trades
Run SQL over the last 30 days of per-second DEX trades.execute_sql (paid plans)

Crypto investigations

Transfer tracing on 19 chains: Ethereum, BNB Chain, Polygon, Arbitrum, Base, Optimism, Robinhood Chain, Arc, Tron, Solana, Bitcoin, Litecoin, Dogecoin, Bitcoin Cash, Dash, Zcash, Cardano, the XRP Ledger and Stellar.

AskTool or guided prompt
Trace where the funds from this wallet went and stop at the first exchange.money_flow prompt
Screen this address for mixer, sanctioned or scam exposure and give a risk verdict.risk_screen prompt
Build a full dossier on this address.address_report prompt
Is this wallet an exchange deposit address, a mixer or a known scam?address_labels
Expand this Bitcoin address into addresses that likely share an owner.btc_related_addresses

Polymarket prediction markets

14 read-only tools over on-chain Polymarket data on Polygon. They cannot place or cancel orders.

AskTool the agent picks
What are the five most traded Polymarket markets in the last 24 hours?polymarket_top_markets
Find the open markets about the Fed rate.polymarket_find_markets
What are the odds on this market right now?polymarket_market_odds
Show the daily close for Yes over the last week.polymarket_market_price_history
Show the latest fills above $10,000 in this market.polymarket_market_trades
Who traded the most in this market?polymarket_top_traders
Is this wallet a market maker or a directional bettor?polymarket_trader_summary
Which outcomes were disputed this week?polymarket_market_disputes

Sample answer to the first question, production server, 21 September 2026 at 09:08 UTC, data 14 minutes behind the clock:

Market24h volumeOrdersWallets
Colts vs. Chiefs$4,114,9439,124292
Will United Russia (ER) gain the most seats in the next Russian parliamentary election?$4,065,4368,532565
Will Manchester City FC win on 2026-09-20?$1,918,4155,523386

polymarket_top_traders ranks wallets by dollars traded and carries no profit figure. The top wallet in the second market above had 48,736 of its 51,391 lifetime orders resting on the book, which is what a market maker looks like. Six worked questions with full output are on the Polymarket MCP page. To follow large traders, see Track Polymarket whales and top traders. For volume, odds history and holders, see Polymarket analytics with AI. For building in code, see the Polymarket GraphQL API docs.

Solana and pump.fun

Eleven solana_ tools cover transfers, signatures and program instructions, and the market tools cover Solana trades, prices and launches. Read-only: nothing here signs or sends a transaction.

AskTool the agent picks
What are the most traded tokens on Solana in the last 24 hours?trending_tokens
Show new pump.fun tokens from the last 6 hours.new_tokens
How did this launch go in its first 60 seconds?token_launch_stats
Who were the first buyers?early_buyers
Where does this token trade, and how many wallets trade it?token_dex_venues
Where did this wallet send its SOL?solana_trace_next_hop

Check the token address before you trust a row. On 21 September 2026 the top "USDT" in Solana's 24-hour volume ranking was a counterfeit: token_dex_venues showed 5 trades between 2 wallets behind a reported $986,660,608. Six worked questions with full output are on the Solana MCP page.

Hyperliquid

18 read-only tools over the exchange's own blocks: perpetuals, spot pairs, third-party markets and outcome markets. They cannot place or cancel orders.

AskTool the agent picks
What are the five most traded Hyperliquid markets today?hyperliquid_markets
Show open interest, the long and short split, and funding.hyperliquid_open_interest
How has BTC funding moved over the last 24 hours?hyperliquid_funding_rates
Which markets had the most value liquidated, and on which side?hyperliquid_liquidations
Who made the most trading BTC in the last 24 hours?hyperliquid_top_traders
What positions does this wallet hold?hyperliquid_trader_positions

Sample, production server, 21 September 2026 between 10:21 and 10:25 UTC, after Bitcoin rose 5.4% in a day: the 9,334 BTC liquidations in 24 hours were worth $92,691,944 and 9,265 of them were shorts, and BTC funding went from 10.95% to 78.64% per year within two hours. Profit rankings leave out open positions, so read a wallet's positions before calling it a winner. Six worked questions are on the Hyperliquid MCP page.

Plans

PlanPriceCredits per monthTools
Trialfree, 7 days100see the pricing page
Trading MCP$19 per month ($13 billed yearly)25,00032, market data
AI Investigation MCP$149 per month ($100 billed yearly)200,000all 314, data plus labels and tracing

Paid API plans can add MCP credits without changing plan. Current pricing: bitquery.io/products/bitquery-mcp-server.

Docs

Support

Questions and bugs: open an issue here, or write to [email protected]. Account and billing questions go to support, since issues here are public.

How this page was made

Drafted with AI assistance. Every command, price, plan and tool name was checked against the live product page and the live endpoint on 21 September 2026. The yearly prices in the plans table were checked again against the billing catalogue on 2 October 2026.

Source: README.md at commit 9159400

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v1.0.2LatestSep 21, 2026
  2. v1.0.1Sep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Bitquery integrations

Bitquery

Published by GitHub account pipeworx-io

Pipeworx gateway pack exposing Bitquery blockchain data: DEX trades, token transfers and top holders across EVM chains, plus gateway meta-tools.

Streamable HTTPWeb executable
Databases47 toolsOct 30, 2026