Bitquery MCP: on-chain trading data in plain English

Add Bitquery to Claude, ChatGPT or Cursor

1. 1Click Connect Bitquery free and sign in with your with your Bitquery account.
2. 2The full list appears after you connect, with every tool on. Bitquery is for looking up chain data, so switch off whatever your team won't use, for example real-time streams when you only need history.
3. 3Add ContextGate to your AI app as a connector or MCP server. The steps for each app are on the Works with page.
4. 4Ask your AI app for the top traders of a token on a DEX over the last day, then open Activity to see the query it ran.

On-chain questions for Claude or ChatGPT

• Pull DEX trades and OHLCV price candles for a token without writing GraphQL against the Bitquery API.
• Find the top traders for a token and trace where a wallet's funds went.
• Label addresses so a list of wallets reads as names, not hashes.
• Ask about Polymarket odds or Hyperliquid positions in plain English.
• Choose archive, real-time or combined data across more than 40 blockchains.

See every on-chain lookup

• Switch off any Bitquery tool you don't want in use; it's hidden from your AI app and refused if called.
• Policies check each query, so an API key pasted into a prompt can be blocked before it reaches Bitquery.
• Activity records every Bitquery call, which helps when you need to show how a number in a report was found.

What you get with Bitquery and ContextGate

• Your AI apps can use BitqueryClaude, Cursor, ChatGPT and other AI apps reach Bitquery through the one ContextGate connection you add to them.
• You choose which tools they can useSwitch off any Bitquery tool you don't want used. It's hidden from your AI apps and refused if called.
• Every call is checked and recordedYour policies check each call (for example, personal data is hidden and secrets are blocked), and Activity keeps a record of it.

ContextGate sees only the tool calls that go through it, not your AI app's built-in tools or your chats.

Bitquery tools

Examples of what your AI apps can do in Bitquery. You'll see the exact list of tools after you connect it.

• Combined Database QueryTool to query the combined database, which merges archive and real-time databases. use when you need both historical and up-to-the-second blockchain data in one request.
• Aliases MetricTool to use graphql aliases to rename fields in the response for clarity and disambiguation. use when you need to query multiple metrics with identical field names in one call.
• Archive Database QueryTool to query the archive database. use when you need full historical blockchain data (delayed by tens of minutes to hours).
• Conditional Metrics SnippetTool to generate a graphql metric snippet with conditional logic. use when you need to apply filters directly on metric calculations via the `if` attribute.
• Count Distinct MetricTool to use the count distinct metric to aggregate unique values for a field. use when you need to count the number of unique occurrences in a dataset.
• Count MetricTool to use the count metric to aggregate the number of records matching a graphql query. use when you need simple record counts.
• Database SelectionTool to select the database (archive, realtime, combined) to query at the top level of a graphql request. use after determining whether you need live, historical, or combined blockchain data.
• Early Access Program QueryTool to access streaming data across various blockchain networks for evaluation purposes. use when querying chains not available via the v2 endpoint; limited to real-time data only.
• Mempool SubscriptionTool to subscribe to real-time mempool updates for evm chains (ethereum, bnb, etc.). use after constructing your graphql subscription to stream pending transactions live.
• Network SelectionTool to select the blockchain network for graphql queries. use before constructing dataset or metric queries to ensure the correct chain is targeted.
• Options QueryTool to fetch graphql dataset options via schema introspection. use when you need to discover root-level query fields and their arguments before building queries.
• Price Asymmetry MetricTool to generate graphql priceasymmetry filter snippet. use when you need to filter trades based on price asymmetry metric.
• Quantile MetricTool to calculate quantiles to understand the distribution of numerical data. use when you need percentile metrics (e.g., median or quartiles) of a numerical field in a dataset.
• Realtime Database QueryRealtime database query
• Select By MetricTool to generate a graphql metric snippet filtering by its value using selectwhere. use when you need to include only metrics meeting specific value conditions (e.g., only positive sums).
• Statistics MetricTool to compute statistical metrics (mean, median, etc.) over one variable in a dataset. use when you need precise summary statistics in your graphql query.
• Sum MetricTool to calculate the sum of a specified field's values across defined dimensions. use when you need to aggregate total values in a dataset.
• Uniq MetricTool to estimate the count of unique values using the uniq metric. use when you need approximate or exact unique counts for analytics on blockchain datasets.