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

Q: How does Pydantic AI query account details using TzKT (Tezos Indexer & Explorer API)?

The agent uses getaccount to pull the data. Because you're using Pydantic, any unexpected field or bad structure in the MCP Server response will fail loudly, keeping your system correct.

Q: Can I find all listable contracts with TzKT (Tezos Indexer & Explorer API) using Pydantic AI?

You use listcontracts to get a filtered view of smart contracts. The MCP Server ensures the returned data adheres to defined types, eliminating guesswork.

Q: What is the best way to track token transfers with TzKT (Tezos Indexer & Explorer API) via Pydantic AI?

Use listtokentransfers. This tool provides transfer records for FA1.2 and FA2 tokens, giving you structured data that's safe to consume in Python.

Q: Does the MCP Server support listing all big maps with TzKT (Tezos Indexer & Explorer API) using Pydantic AI?

Yes. You can use listbigmaps to see all available big map identifiers, and then listbigmapupdates gets the update history for a specific map.

Ensure perfect Tezos data structure with Pydantic AI. Use the TzKT (Tezos Indexer & Explorer API) for type-safe blockchain interactions.

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

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get Account Data and Reports

The `get_account` tool fetches detailed info for a specific account, which you can then validate against Pydantic schemas. You'll also use `list_accounts` to pull filtered lists of multiple addresses. For compliance or reporting, the agent runs `get_account_report`, receiving a predictable JSON structure that won't break your downstream logic.

Track and List Tokens

Working with assets? Use `list_token_definitions` to get metadata for tokens, ensuring you know the correct identifiers. The agent then uses `list_token_balances` to pull amounts, which are validated instantly. If tracking movement is key, `list_token_transfers` lists both FA1.2 and FA2 transfers in a strictly typed format.

Examine System Operations

The MCP Server lets you see network-wide health metrics via `get_statistics`. Need to check what's going on with contracts? You can list them with filters using `list_contracts`. To get granular operational data, use `get_operations_by_hash` or run `list_originations` to track how contracts were first created.

Setup guide

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

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

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

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to TzKT (Tezos Indexer & Explorer API) tools.",
)

result = await agent.run("List recent TzKT (Tezos Indexer & Explorer API) transactions")
print(result.output)

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

The agent uses `get_account` to pull the data. Because you're using Pydantic, any unexpected field or bad structure in the MCP Server response will fail loudly, keeping your system correct.

You use `list_contracts` to get a filtered view of smart contracts. The MCP Server ensures the returned data adheres to defined types, eliminating guesswork.

Use `list_token_transfers`. This tool provides transfer records for FA1.2 and FA2 tokens, giving you structured data that's safe to consume in Python.

Yes. You can use `list_bigmaps` to see all available big map identifiers, and then `list_bigmap_updates` gets the update history for a specific map.

This MCP Server touches contract storage, big map keys, and operational records. The rigorous schema validation means you trust the structure of every piece of data.

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