How to Use the TzKT (Tezos Indexer & Explorer API) MCP in Claude

Q: Can I track historical movements with TzKT (Tezos Indexer & Explorer API) in Claude Desktop?

Yeah, absolutely. The getaccountbalancehistory tool pulls a full record of balance changes. You can also check the update history for specific big maps using listbigmapupdates.

Q: What if I need to list multiple smart contracts with TzKT (Tezos Indexer & Explorer API) in Claude Desktop?

You use the listcontracts tool. You can filter these lists by various criteria, giving you a clean overview of all deployed assets on the Tezos network.

Q: Does the MCP Server handle large datasets for TzKT (Tezos Indexer & Explorer API) in Claude Desktop?

It handles it fine. Tools like listtransactions allow advanced filtering, so you aren't dumped a massive list of every transaction ever. You narrow down exactly what you need.

TzKT (Tezos Indexer & Explorer API): Deep blockchain data access for your Claude Desktop workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect TzKT (Tezos Indexer & Explorer API) MCP to Claude Desktop

Create your Vinkius account to connect TzKT (Tezos Indexer & Explorer API) to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup TzKT (Tezos Indexer & Explorer API) with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Track Account History with the MCP Server

Need to see where an account’s money went? Use `get_account_balance_history` to pull a full ledger of balance changes for any Tezos address. This goes beyond just checking the current balance; you get the transaction details and timing. You can also generate a detailed JSON report using `get_account_report`. It compiles all that activity into one file, perfect for passing along to your team or dumping into a database.

Explore Smart Contract Logic

Figure out what the code actually does. The tools let you fetch contract details using `get_contract_code` (Michelson/Micheline) and see exactly which functions are exposed with `get_contract_entrypoints`. This is critical when analyzing DeFi protocols. Want to know how much storage a smart contract uses? Check the current or historical state with `get_contract_storage`. It gives you a clear picture of the data layer.

Audit Network Activity and Transfers

Monitor token movement across the chain. The tool `list_token_transfers` lists all FA1.2 or FA2 transfers, letting you follow specific assets from point A to B. You can also check total holdings for an address using `list_token_balances`. For a broader view, run `get_statistics` to get network-wide numbers like Transactions Per Second (TPS) and overall volume.

Setup guide

Set up TzKT (Tezos Indexer & Explorer API) MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The TzKT (Tezos Indexer & Explorer API) MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the TzKT (Tezos Indexer & Explorer API) MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under tzkt-tezos-indexer-explorer-api-mcp.

json

{
  "mcpServers": {
    "tzkt-tezos-indexer-explorer-api-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by TzKT. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect TzKT (Tezos Indexer & Explorer API) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about TzKT (Tezos Indexer & Explorer API) MCP in Claude Desktop

You connect it through the Claude Desktop app settings. Once connected, your AI client can treat the Tezos data like any other API endpoint. You just ask for an account report, and it runs the query locally.

Yeah, absolutely. The `get_account_balance_history` tool pulls a full record of balance changes. You can also check the update history for specific big maps using `list_bigmap_updates`.

You use the `list_contracts` tool. You can filter these lists by various criteria, giving you a clean overview of all deployed assets on the Tezos network.

It handles it fine. Tools like `list_transactions` allow advanced filtering, so you aren't dumped a massive list of every transaction ever. You narrow down exactly what you need.

This server touches public blockchain data, including account addresses, token transfers (FA1.2/FA2), and transaction hashes. It only accesses publicly verifiable ledger information.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript