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

Q: Can I track account balance changes using TzKT (Tezos Indexer & Explorer API) and Mastra AI?

Yes. You can monitor historical movements by calling getaccountbalancehistory. This data helps your autonomous workflow check if an expected asset transfer actually occurred.

Q: Does Mastra AI support listing contracts with filters using the MCP Server?

Absolutely. You can use the listcontracts tool, filtering by parameters like contract type or creation date, which is critical for scoping complex automation jobs.

Q: How do I get current block details with TzKT (Tezos Indexer & Explorer API) using Mastra AI?

You call getblock directly within your workflow. This provides the immediate state of a blockchain block, allowing your automation to verify timing or sequence dependencies.

Build resilient Tezos workflows with Mastra AI's native agent framework.

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 Mastra AI

Create your Vinkius account to connect TzKT (Tezos Indexer & Explorer API) to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Reliable Web3 Workflow Management for Mastra AI

Building complex logic requires more than just a single API call. Use `list_delegations` and `get_delegator_rewards` in multi-step workflows to calculate total staking yields, handling retries if the network is slow. The built-in workflow engine ensures your process finishes even if one step fails.

MCP Server for Detailed Account Auditing

When you need a full picture of an account's activity, Mastra AI runs tools like `get_account_report` to generate a JSON summary. You can combine this with `list_bigmap_updates` to track exactly how contract storage changed over time, ensuring your automation is airtight.

Automating Tezos Asset Listing and Verification

Mastra AI makes it easy to build processes that list every asset on a chain. Use `list_contracts` or `list_token_definitions` to pull metadata, then use `get_contract_entrypoints` to verify the contract's available functions before executing any actions in your workflow.

Setup guide

Set up TzKT (Tezos Indexer & Explorer API) MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All TzKT (Tezos Indexer & Explorer API) tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "tzkt-tezos-indexer-explorer-api-mcp-client",
  servers: {
    "tzkt-tezos-indexer-explorer-api-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "TzKT (Tezos Indexer & Explorer API) Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to TzKT (Tezos Indexer & Explorer API) tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent TzKT (Tezos Indexer & Explorer API) transactions"
);
console.log(result.text);

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 Mastra AI

Mastra AI treats MCP Server tools as reliable steps in a larger process. You can set up conditional logic: if `list_token_balances` returns zero for a specific asset, then trigger an alert workflow.

Yes. You can monitor historical movements by calling `get_account_balance_history`. This data helps your autonomous workflow check if an expected asset transfer actually occurred.

The server handles public blockchain records, specifically account balances and token transfers. The scope is limited to immutable ledger information accessed via tools like `list_token_transfers`.

Absolutely. You can use the `list_contracts` tool, filtering by parameters like contract type or creation date, which is critical for scoping complex automation jobs.

You call `get_block` directly within your workflow. This provides the immediate state of a blockchain block, allowing your automation to verify timing or sequence dependencies.

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