• AUTOMATION
  • SECURITY
  • EFFICIENCY
  • HUMAN

How to authenticate bitquery api access with your AI

Connect your agent to the Bitquery index once. It handles the token rotation so your data queries never drop due to expired credentials.

Ask AI about this page

Short answer

How do I authenticate bitquery api access with my AI?

The Bitquery MCP uses the generate_token tool to fetch and refresh OAuth2 access tokens automatically. This keeps your agent's connection to the blockchain index active without you needing to manually update headers or keys. You'll see how the automation handles the handshake below.

The results of authentication

What you get from a live connection

Once the agent is authenticated, it can manage the connection on its own.

AUTOMATION

Continuous index access

The AI uses the token tool to prevent connection timeouts. You get uninterrupted access to blockchain data.

SECURITY

Protected credentials

Tokens are generated and managed through the MCP. Your raw API secrets stay out of your chat history.

EFFICIENCY

Zero-touch rotation

The agent handles the OAuth2 handshake in the background. You focus on the GraphQL queries, not the auth logic.

HUMAN

Manual oversight

You decide when to trigger a new token request. The AI won't force a re-auth if you want to stay offline.

The workflow

What your AI does when the connection is requested.

The AI manages the heavy lifting of the OAuth2 handshake.

  1. Detecting expiration

    Your agent identifies that a valid token is missing or expired for the Bitquery index.

    generate_token

  2. Fetching tokens

    The AI calls the specific tool to get a fresh OAuth2 access token from the provider.

    generate_token

  3. Applying credentials

    The new token is injected into the request headers for subsequent GraphQL calls.

    generate_token

  4. Maintaining state

    The agent keeps the connection stable by monitoring token validity for future queries.

    generate_token

Try it

Copy these to start.

Use these prompts to kick off your Bitquery workflow.

Starting points

These are opening lines. Swap out the specific blockchain or query details to match your needs.

Bitquery Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_KU35mdsrfwl05byKZplozxH5s4oOqPEODwO2ZR75/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Bitquery capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "bitquery-web3-blockchain-graphql-apis-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_KU35mdsrfwl05byKZplozxH5s4oOqPEODwO2ZR75/mcp"
    }
  }
}
Copy into chat04

  • Generate a new Bitquery OAuth2 token so I can query Ethereum transactions.

  • Check my current Bitquery connection status and refresh the token if it's expired.

  • Use the Bitquery MCP to pull the latest block data using a fresh access token.

  • Help me write a GraphQL query for Solana volume and handle the authentication automatically.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Bitquery once, then ask.

Click the link to connect your Bitquery account. Your credentials stay encrypted, and you can immediately start querying the blockchain with your agent.

Connect Bitquery to your AI

FAQ

How this task behaves

  • 01

    Does the AI store my Bitquery API keys?

    No. Your credentials are encrypted and managed by Vinkius, not stored in the AI's chat memory.

  • 02

    Can the AI change my Bitquery account settings?

    No. The AI only has permission to use the generate_token tool to facilitate data access.

  • 03

    Will I have to manually refresh tokens every hour?

    No. The AI uses the automation tool to handle the rotation for you.

  • 04

    Can the AI delete my Bitquery data?

    No. The available tools are strictly for authentication and data retrieval.

  • 05

    What happens if the token generation fails?

    The AI will report the error to you. You will need to check your Bitquery account permissions manually.

  • More questions about Bitquery? The Connector page answers them. See everything the Bitquery Connector can do

Connect Bitquery to Claude, Cursor, ChatGPT & more