• DATA
  • HISTORY
  • SPECS
  • HUMAN

How to track Tezos FA2 token transfers with your AI

Connect TzKT to your AI client to watch token balances and transaction histories on the Tezos blockchain.

Ask AI about this page

Short answer

How can I track Tezos FA2 token transfers using AI?

Your AI uses the TzKT connector to pull specific token definitions, current balances, and historical transfer logs. You get a clear view of wallet activity and asset distributions.

The outcomes

What you get from this connection

The AI turns raw blockchain data into answers.

DATA

Live token balances

The AI pulls current holdings for any address. You get instant updates on how much of a specific FA2 token a wallet holds.

HISTORY

Transfer logs

Your agent scans the movement history of tokens. It identifies who sent what to whom and when.

SPECS

Token definitions

The AI reads the technical parameters of FA2 tokens. This ensures it understands the specific rules of the assets it is tracking.

HUMAN

Manual verification

You remain the final authority. The AI provides the data, but you decide which transactions require further investigation.

The workflow

What your AI does when the data arrives.

The AI acts as a bridge between the Tezos blockchain and your chat interface.

  1. Identify tokens

    The agent looks up the specific technical details and metadata for the FA2 assets you are interested in.

    list_token_definitions

  2. Check holdings

    The AI queries the current amount of tokens held by a specific Tezos address.

    list_token_balances

  3. Trace movement

    Your agent pulls a list of all recent transfers to see how tokens have moved between wallets.

    list_token_transfers

  4. Summarize activity

    The AI processes the raw transfer logs to give you a plain English summary of recent wallet activity.

    list_token_transfers

Try it

Copy these to start.

Use these prompts to begin interacting with the Tezos blockchain.

Starting points

Replace the wallet addresses and token IDs with your actual Tezos data.

TzKT Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_dOE3JyfNcsVXKuLGFQTRo4NEbU7xFJomMmGxoKc9/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 — TzKT capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "tzkt-tezos-indexer-explorer-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_dOE3JyfNcsVXKuLGFQTRo4NEbU7xFJomMmGxoKc9/mcp"
    }
  }
}
Copy into chat04

  • What is the current balance of the FA2 token at address tz1...

  • Show me the last ten transfers for the token with ID...

  • List all token balances for the wallet address tz1...

  • Summarize the recent transfer history for this specific FA2 token.

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

Start here

Connect TzKT once, then ask.

One click connects the MCP to your client. Your credentials stay encrypted, and you can start querying the Tezos blockchain immediately.

Connect TzKT to your AI

FAQ

How this task behaves

  • 01

    Can the AI execute a token transfer?

    No. The AI can only read data from the blockchain. It cannot sign transactions or move funds.

  • 02

    Does the AI support FA1.2 tokens?

    The tools provided are specifically for the FA2 standard.

  • 03

    Can the AI delete my transaction history?

    No. The AI only reads data from the TzKT indexer. It has no ability to modify or delete blockchain records.

  • 04

    How recent is the data?

    The AI pulls data directly from the TzKT indexer, which reflects the current state of the Tezos blockchain.

  • 05

    Can the AI create new tokens?

    No. The AI is limited to reading token definitions, balances, and transfers.

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

Connect TzKT to Claude, Cursor, ChatGPT & more