# Bitquery MCP Server

Bitquery MCP Server feeds on-chain DEX trades, prices and wallet activity straight into agent chats. Runs as a hosted service, nothing to install locally.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: bitquery
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bitquery/mcp
- Updated: 2026-10-07
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/bitquery-mcp-server

## What it does

The server covers trades and quotes on Ethereum, Arbitrum, Base, Polygon, Optimism, BNB Chain, Tron and Solana, plus Polymarket and Hyperliquid markets. The agent picks the right tool on its own, say `trending_tokens` for Solana's movers or `pair_ohlcv` for candle data on a Uniswap v3 pair.

A separate set of tools handles investigations: following transfers across 19 chains, flagging an address for mixer or sanctions exposure, and tagging wallets as exchanges, scams or something else. For Bitcoin there's a tool that clusters addresses likely controlled by one owner.

Login runs through OAuth 2.1 tied to a Bitquery account, so there's no API key or config file to manage. The endpoint `https://mcp.bitquery.io` speaks Streamable HTTP, and running raw SQL over 30 days of trade history (`execute_sql`) is limited to paid plans.

## Requirements
- Remote server: `https://mcp.bitquery.io`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http bitquery-mcp-server https://mcp.bitquery.io
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add bitquery-mcp-server --url https://mcp.bitquery.io
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bitquery-mcp-server": {
            "url": "https://mcp.bitquery.io"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bitquery-mcp-server": {
            "type": "http",
            "url": "https://mcp.bitquery.io"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http bitquery-mcp-server https://mcp.bitquery.io
```

## When to use it
- flag a wallet for mixer or scam exposure
- pull trade history for a token on a DEX
- find the top-performing traders on a given token this month
- trace where funds from a wallet moved before hitting an exchange
- get OHLCV candles for a trading pair without running your own indexer

## Example prompts
- Show the top 5 Polymarket markets by 24-hour volume
- Screen this address for mixer, sanctions or scam risk
- Cluster this Bitcoin wallet's transfers to find addresses likely under the same owner

## Similar
- [market-microstructure](https://affpapa.org/en/nevibecode/skills/market-microstructure.md) — skill · 579 installs
- [birdeye-api](https://affpapa.org/en/nevibecode/skills/birdeye-api.md) — skill · 501 installs
- [Antalpha-MCP](https://affpapa.org/en/nevibecode/mcp/antalpha-mcp.md) — MCP server · 155 installs
- [Vike Data API](https://affpapa.org/en/nevibecode/mcp/vike-data-api.md) — MCP server · ★ 1 repo stars
- [dexpaprika-api](https://affpapa.org/en/nevibecode/skills/dexpaprika-api.md) — skill · ★ 36 repo stars
- [Hyperliquid Spot — 454 Tokens, Prices, Balances](https://affpapa.org/en/nevibecode/mcp/hyperliquid-spot-454-tokens-prices-balances.md) — MCP server · 3947 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
