Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Bitquery MCP connector

OAuth 2.1/DCRAnalyticsAIDatabases

Connect to Bitquery MCP. Query on-chain DEX trading data, token prices, OHLCV series, trader profiles, and trending tokens across multiple blockchains...

Bitquery MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'bitquerymcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Bitquery MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'bitquerymcp_find_currencies',
      toolInput: { query: 'YOUR_QUERY' },
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Tokens trending, find — Find trending tokens by volume or trade count on a blockchain over a given time window
  • Profile trader — Get a summary profile of a wallet’s recent trading behavior, including tokens traded and volume
  • Positions trader — Retrieve the current token positions held by a trader wallet across blockchains
  • Activity trader — Retrieve a wallet’s trading activity bucketed by time interval to show trading patterns
  • Token top traders by, profitable traders by, accumulating traders by — Find the most active or highest-volume traders for a specific token over a given time window
  • Pair top traders by — Find the top traders for a specific base/quote token pair over a given time window

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

bitquerymcp_accumulating_traders_by_token#Find wallets with the highest net buy volume for a token over a given time window.5 params

Find wallets with the highest net buy volume for a token over a given time window.

NameTypeRequiredDescription
addressstringrequiredToken contract address. Lowercase 0x-hex for EVM; base58 for Solana/Tron.
blockchainstringrequiredToken_Network — Ethereum, Arbitrum, Base, Matic, Optimism, Binance Smart Chain, Tron, or Solana.
limitintegeroptionalMax traders to return.
min_net_buy_usdintegeroptionalFilter out traders whose net accumulation is below this USD threshold.
window_hoursintegeroptionalLook-back window in hours. Max 720 (30 days).
bitquerymcp_currency_ohlcv#Retrieve OHLCV (open, high, low, close, volume) price series for a well-known currency like USDC, USDT, or WETH.4 params

Retrieve OHLCV (open, high, low, close, volume) price series for a well-known currency like USDC, USDT, or WETH.

NameTypeRequiredDescription
currency_idstringrequiredCurrency_Id — lower-case name for well-known currencies (e.g. usdc, usdt, weth), or `bid:<blockchain>` for native currencies (e.g. bid:eth, bid:solana).
interval_secondsintegeroptionalCandle size in seconds. One of 1, 3, 5, 10, 30, 60, 300, 900, 1800, 3600.
limitintegeroptionalMax candles to return (most recent first).
window_hoursintegeroptionalLook-back window in hours from now. Keep reasonable relative to interval size.
bitquerymcp_currency_price#Get the latest price for a well-known currency such as USDC, USDT, or WETH.1 param

Get the latest price for a well-known currency such as USDC, USDT, or WETH.

NameTypeRequiredDescription
currency_idstringrequiredCurrency_Id — lower-case name for well-known currencies (e.g. usdc, usdt, weth), or `bid:<blockchain>` for native currencies (e.g. bid:eth, bid:solana).
bitquerymcp_currency_supply#Retrieve the total and circulating supply for a well-known currency.1 param

Retrieve the total and circulating supply for a well-known currency.

NameTypeRequiredDescription
currency_idstringrequiredCurrency_Id — lower-case name for well-known currencies (e.g. usdc, usdt, weth), or `bid:<blockchain>` for native currencies (e.g. bid:eth, bid:solana).
bitquerymcp_execute_sql#Execute a raw SQL query against the Bitquery blockchain data warehouse and return the results.1 param

Execute a raw SQL query against the Bitquery blockchain data warehouse and return the results.

NameTypeRequiredDescription
sqlstringrequiredThe SQL statement to execute.
bitquerymcp_find_currencies#Search for well-known currencies by name or symbol and return matching results.2 params

Search for well-known currencies by name or symbol and return matching results.

NameTypeRequiredDescription
querystringrequiredCase-insensitive substring matched against Currency_Name and Currency_Symbol (e.g. "usdc", "ether").
limitintegeroptionalMax rows to return.
bitquerymcp_find_token_by_address#Look up a token's metadata and trading details using its contract address and blockchain.2 params

Look up a token's metadata and trading details using its contract address and blockchain.

NameTypeRequiredDescription
addressstringrequiredToken address. Lowercase 0x-hex for EVM; base58 as-is for Solana/Tron.
blockchainstringrequiredToken_Network — one of Ethereum, Arbitrum, Base, Matic, Optimism, Binance Smart Chain, Tron, Solana.
bitquerymcp_find_tokens#Search for tokens by name or symbol across one or all blockchains and return matching results.3 params

Search for tokens by name or symbol across one or all blockchains and return matching results.

NameTypeRequiredDescription
querystringrequiredCase-insensitive substring matched against Token_Name and Token_Symbol (e.g. "pepe", "wrapped eth").
blockchainstringoptionalExact Token_Network to restrict to — one of Ethereum, Arbitrum, Base, Matic, Optimism, Binance Smart Chain, Tron, Solana. Pass empty string to search all chains.
limitintegeroptionalMax rows to return.
bitquerymcp_pair_ohlcv#Retrieve OHLCV price series for a specific base/quote token pair on a given blockchain.7 params

Retrieve OHLCV price series for a specific base/quote token pair on a given blockchain.

NameTypeRequiredDescription
base_addressstringrequiredBase token contract address (the asset being priced). Lowercase 0x-hex for EVM; base58 as-is for Solana/Tron.
blockchainstringrequiredToken_Network — Ethereum, Arbitrum, Base, Matic, Optimism, Binance Smart Chain, Tron, or Solana. Base and quote must be on the same network.
quote_addressstringrequiredQuote token contract address (the asset the price is expressed in — e.g. WETH, USDC, WSOL).
interval_secondsintegeroptionalCandle size in seconds. One of 1, 3, 5, 10, 30, 60, 300, 900, 1800, 3600.
limitintegeroptionalMax candles to return (most recent first).
quote_instringoptional"usd" (default) for USD-priced candles; "quote" for candles priced in the quote token.
window_hoursintegeroptionalLook-back window in hours from now.
bitquerymcp_pair_price#Get the latest price of a base token denominated in a quote token on a given blockchain.3 params

Get the latest price of a base token denominated in a quote token on a given blockchain.

NameTypeRequiredDescription
base_addressstringrequiredBase token contract address (the asset whose price and supply you want). Lowercase 0x-hex for EVM; base58 as-is for Solana/Tron.
blockchainstringrequiredToken_Network — Ethereum, Arbitrum, Base, Matic, Optimism, Binance Smart Chain, Tron, or Solana. Base and quote must be on the same network.
quote_addressstringrequiredQuote token contract address (the asset the price is expressed in — e.g. WETH, USDC, WSOL).
bitquerymcp_profitable_traders_by_token#Find the most profitable traders (by realized PnL) for a token over a given time window.5 params

Find the most profitable traders (by realized PnL) for a token over a given time window.

NameTypeRequiredDescription
addressstringrequiredToken contract address. Lowercase 0x-hex for EVM; base58 for Solana/Tron.
blockchainstringrequiredToken_Network — Ethereum, Arbitrum, Base, Matic, Optimism, Binance Smart Chain, Tron, or Solana.
limitintegeroptionalMax traders to return.
min_pnl_usdintegeroptionalFilter out traders whose estimated total P&L is below this USD threshold.
window_hoursintegeroptionalLook-back window in hours. Max 720 (30 days).
bitquerymcp_token_ohlcv#Retrieve OHLCV price series for a token by contract address on a given blockchain.5 params

Retrieve OHLCV price series for a token by contract address on a given blockchain.

NameTypeRequiredDescription
addressstringrequiredToken contract address. Lowercase 0x-hex for EVM; base58 as-is for Solana/Tron.
blockchainstringrequiredToken_Network — Ethereum, Arbitrum, Base, Matic, Optimism, Binance Smart Chain, Tron, or Solana.
interval_secondsintegeroptionalCandle size in seconds. One of 1, 3, 5, 10, 30, 60, 300, 900, 1800, 3600.
limitintegeroptionalMax candles to return (most recent first).
window_hoursintegeroptionalLook-back window in hours from now. Keep reasonable relative to interval size (e.g. 24 for 1m candles, 720 for 1h candles).
bitquerymcp_token_price#Get the latest price and market cap for a token by its contract address.2 params

Get the latest price and market cap for a token by its contract address.

NameTypeRequiredDescription
addressstringrequiredToken contract address. Lowercase 0x-hex for EVM; base58 as-is for Solana/Tron.
blockchainstringrequiredToken_Network — Ethereum, Arbitrum, Base, Matic, Optimism, Binance Smart Chain, Tron, or Solana.
bitquerymcp_token_supply#Retrieve the total and circulating supply for a token by its contract address.2 params

Retrieve the total and circulating supply for a token by its contract address.

NameTypeRequiredDescription
addressstringrequiredToken contract address. Lowercase 0x-hex for EVM; base58 as-is for Solana/Tron.
blockchainstringrequiredToken_Network — Ethereum, Arbitrum, Base, Matic, Optimism, Binance Smart Chain, Tron, or Solana.
bitquerymcp_top_traders_by_network#Find the most active or highest-volume DEX traders on a blockchain over a given time window.5 params

Find the most active or highest-volume DEX traders on a blockchain over a given time window.

NameTypeRequiredDescription
blockchainstringrequiredToken_Network — Ethereum, Arbitrum, Base, Matic, Optimism, Binance Smart Chain, Tron, or Solana.
limitintegeroptionalMax traders to return.
min_trade_usdintegeroptionalMinimum per-trade USD size to count. 0 = all trades.
sortstringoptionalOne of volume_usd, trades.
window_hoursintegeroptionalLook-back window in hours. Keep small — max 24.
bitquerymcp_top_traders_by_pair#Find the top traders for a specific base/quote token pair over a given time window.6 params

Find the top traders for a specific base/quote token pair over a given time window.

NameTypeRequiredDescription
base_addressstringrequiredBase token contract address (the asset whose net position you want to measure). Lowercase 0x-hex for EVM; base58 for Solana/Tron.
blockchainstringrequiredToken_Network — Ethereum, Arbitrum, Base, Matic, Optimism, Binance Smart Chain, Tron, or Solana.
quote_addressstringrequiredQuote token contract address (the asset used to price the base — e.g. WETH, USDC, USDT).
limitintegeroptionalMax traders to return.
sortstringoptionalOne of volume_usd, trades, net_buy_usd, realized_usd.
window_hoursintegeroptionalLook-back window in hours. Max 720 (30 days).
bitquerymcp_top_traders_by_token#Find the most active or highest-volume traders for a specific token over a given time window.5 params

Find the most active or highest-volume traders for a specific token over a given time window.

NameTypeRequiredDescription
addressstringrequiredToken contract address. Lowercase 0x-hex for EVM; base58 as-is for Solana/Tron.
blockchainstringrequiredToken_Network — Ethereum, Arbitrum, Base, Matic, Optimism, Binance Smart Chain, Tron, or Solana.
limitintegeroptionalMax traders to return.
sortstringoptionalOne of volume_usd, trades, net_buy_usd, realized_usd.
window_hoursintegeroptionalLook-back window in hours. Max 720 (30 days).
bitquerymcp_trader_activity#Retrieve a wallet's trading activity bucketed by time interval to show trading patterns.4 params

Retrieve a wallet's trading activity bucketed by time interval to show trading patterns.

NameTypeRequiredDescription
trader_addressstringrequiredWallet address. Lowercase 0x-hex for EVM; base58 as-is for Solana/Tron.
bucketstringoptionalTime-bucket granularity. One of minute, fifteenmin, hour (default), day.
limitintegeroptionalMax buckets to return (most recent first).
window_hoursintegeroptionalLook-back window in hours. Max 720 (30 days).
bitquerymcp_trader_positions#Retrieve the current token positions held by a trader wallet across blockchains.6 params

Retrieve the current token positions held by a trader wallet across blockchains.

NameTypeRequiredDescription
trader_addressstringrequiredWallet address. Lowercase 0x-hex for EVM; base58 as-is for Solana/Tron.
blockchainstringoptionalOptional Token_Network filter. Pass '' for all chains.
limitintegeroptionalMax positions to return.
min_position_usdintegeroptionalKeep only positions whose |Position_Value_Usd| ≥ this USD threshold.
sortstringoptionalOne of position_usd, pnl_usd, realized_usd, volume_usd, last_trade.
window_hoursintegeroptionalLook-back window in hours. Max 720 (30 days).
bitquerymcp_trader_profile#Get a summary profile of a wallet's recent trading behavior, including tokens traded and volume.2 params

Get a summary profile of a wallet's recent trading behavior, including tokens traded and volume.

NameTypeRequiredDescription
trader_addressstringrequiredWallet address. Lowercase 0x-hex for EVM; base58 as-is for Solana/Tron.
window_hoursintegeroptionalLook-back window in hours. Max 720 (30 days).