# TzKT MCP for AI Agents AI Agent Connect

> TzKT (Tezos Indexer & Explorer API) gives your AI agent direct access to live Tezos blockchain data. It lets you query accounts, audit smart contracts, and track transactions across Mainnet, Ghostnet, and Shadownet. Instead of digging through explorer tabs, your agent pulls the exact data you need instantly.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_dOE3JyfNcsVXKuLGFQTRo4NEbU7xFJomMmGxoKc9/ai-agent-connect
- **Tags:** tezos, blockchain-explorer, indexer, smart-contracts, web3

## Description

TzKT connects your AI client to the most advanced indexer for the Tezos blockchain. This Connector lets you pull live on-chain data, analyze smart contract storage, and track financial operations without manual searching. You can ask your agent to find specific accounts based on their balance, pull contract code for auditing, or generate activity reports for a wallet. It handles the heavy lifting of querying the ledger so you can focus on the analysis. Whether you're debugging a contract or looking for transaction flows, this Connector makes the Tezos ecosystem searchable through your existing chat interface. It's a core component of the Vinkius catalog, making it easy to plug into your existing setup and start pulling real-time blockchain data immediately.

## Tools

### get_contract_code
Pull the Michelson or Micheline code for a smart contract. This is essential for security audits.

### get_contract_entrypoints
See all the functions you can call on a specific contract. It helps you understand what a contract actually does.

### get_contract_storage
View the current or past storage of a smart contract. This is a must-have for debugging contract states.

### get_delegator_rewards
Find out how many rewards a delegator received per cycle. It helps track staking yields.

### get_head
See the current state of the blockchain head. Use this to check the latest confirmed data.

### get_operations_by_hash
Find the details of an operation using its unique hash. It's the fastest way to look up a single transaction.

### get_statistics
Pull network-wide stats like TPS and volume. Use this to monitor the health of the Tezos network.

### list_accounts
Find accounts that match specific filters like balance or activity type. It helps you discover active wallets.

### list_bigmap_keys
See all the keys inside a specific big map. This is useful for inspecting complex contract data.

### list_bigmap_updates
Get the history of updates for a specific big map. It lets you see how data changes over time.

### list_bigmaps
See a list of every big map on the network. Use this to explore the broader contract landscape.

### list_blocks
Find blocks that meet your specific criteria. It helps you navigate the history of the blockchain.

### list_contracts
Search for smart contracts using various filters. Use this to find specific projects or protocols.

### list_delegations
See all the delegation operations happening on the network. It helps you track how users are participating in the network.

### list_originations
See the operations where contracts were first created. Use this to track new project launches.

### list_staking
Find all staking-related operations on the blockchain. It helps you see the overall staking activity.

### list_token_balances
See how many tokens different accounts hold. It is perfect for checking distributions across multiple wallets.

### list_token_definitions
Get the metadata and definitions for various tokens. Use this to identify different assets on the chain.

### list_token_transfers
See all FA1.2 and FA2 token transfers. It helps you track the flow of specific assets.

### list_transactions
Search for transactions using advanced filters. Use this to find specific types of activity across the network.

### get_account_balance_history
See how an account's balance changed over time. It helps you track historical funding or spending.

### get_account_report
Get a JSON summary of all activity for a specific address. This is great for automated reporting.

### get_account
Pull the full profile for a specific Tezos account. Use this to see basic account details quickly.

### get_baker_rewards
Check how many rewards a baker earned in a specific cycle. It helps monitor network participation.

### get_block
Fetch details for a specific block using its level or hash. You can use this to inspect the state of the chain.

## Prompt Examples

**Prompt:** 
```
Find the top 5 accounts on Tezos mainnet with a balance over 1000 XTZ.
```

**Response:** 
```
I've queried the mainnet for high-balance accounts. Here are the top 5:

| Address | Balance | Activity Level |
| :--- | :--- | :--- |
| `tz1...` | 1,500 XTZ | High |
| `tz1...` | 1,200 XTZ | Medium |
| `tz1...` | 1,150 XTZ | High |
| `tz1...` | 1,080 XTZ | Low |
| `tz1...` | 1,050 XTZ | Medium |

Would you like me to generate a full activity report for any of these?
```

**Prompt:** 
```
What are the entrypoints for contract KT1PWx2mnDuep3UMCcAgST9SetSjSEu7RZK1?
```

**Response:** 
```
I've retrieved the entrypoints for that contract. It features the following callable functions:

* **transfer**
* **mint**
* **burn**
* **set_metadata**

Which one would you like to inspect further?
```

**Prompt:** 
```
Get the details for transaction ooVp... on Ghostnet.
```

**Response:** 
```
Searching Ghostnet for operation `ooVp...`.

**Found it!**
* **Status:** Applied
* **Amount:** 50 XTZ
* **From:** `tz1...` 
* **To:** `tz1...` 
* **Block Level:** 1,234,567

Let me know if you need the history for this specific sender.
```

## Capabilities

### Fetch historical balance changes
See how an account's balance changed over time.

### Generate JSON activity reports
Get a structured summary of all activity for a specific address.

### Pull detailed account profiles
Get the full profile for a specific Tezos account.

### Get baker rewards
Check how many rewards a baker earned in a specific cycle.

### Fetch block details
Get details for a specific block using its level or hash.

### Retrieve contract code
Pull the Michelson or Micheline code for a smart contract.

### List contract entrypoints
See all the functions you can call on a specific contract.

### Get contract storage
View the current or past storage of a smart contract.

### Fetch delegator rewards
Find out how many rewards a delegator received per cycle.

### View blockchain head
See the current state of the blockchain head.

### Get operations by hash
Find the details of an operation using its unique hash.

### Pull network statistics
Get network-wide stats like TPS and volume.

### List accounts with filters
Find accounts that match specific filters like balance or activity type.

### List big map keys
See all the keys inside a specific big map.

### Get big map updates
Get the history of updates for a specific big map.

### List all big maps
See a list of every big map on the network.

### List blocks with filters
Find blocks that meet your specific criteria.

### List smart contracts
Search for smart contracts using various filters.

### List delegation operations
See all the delegation operations happening on the network.

### List contract originations
See the operations where contracts were first created.

### List staking operations
Find all staking-related operations on the blockchain.

### Get token balances
See how many tokens different accounts hold.

### Get token definitions
Get the metadata and definitions for various tokens.

### List token transfers
See all FA1.2 and FA2 token transfers.

### List transactions
Search for transactions using advanced filters.

## Use Cases

### Contract Auditing
A developer wants to know if a contract has a specific entrypoint. They ask the agent to list entrypoints for a KT1 address using `get_contract_entrypoints`.

### Whale Tracking
An analyst wants to find high-balance accounts. They ask the agent to find accounts with a balance over 10,000 XTZ using `list_accounts`.

### DeFi Analysis
A user wants to see how much a delegator earned. They ask the agent to pull the rewards for a specific cycle using `get_delegator_rewards`.

### Transaction Debugging
A dev needs to see why a transaction failed. They provide the hash and ask the agent to fetch the details using `get_operations_by_hash`.

## Benefits

- Stop manually searching explorers; use `list_accounts` to find specific wallets based on balance or activity directly in your chat.
- Audit smart contracts faster by pulling Michelson code with `get_contract_code` and checking storage with `get_contract_storage`.
- Automate financial reporting by asking your agent to generate JSON reports for any address using `get_account_report`.
- Monitor network health in real-time with `get_statistics` to see TPS and volume without switching tabs.
- Track token movements across the ecosystem by listing all FA1.2 and FA2 transfers with `list_token_transfers`.

## How It Works

The bottom line is it turns the Tezos blockchain into a searchable database for your agent.

1. Subscribe to the TzKT MCP via the Vinkius marketplace.
2. Provide your TzKT API key in the configuration to increase your rate limits.
3. Ask your AI client to query specific Tezos data like balances or contract codes.

## Frequently Asked Questions

**Can I use TzKT MCP to check my Tezos wallet balance?**
Yes, it can pull your account details and balance history. You can ask your agent to check your balance or summarize your recent activity.

**Does TzKT MCP work on Tezos testnets?**
Yes, it supports Mainnet, Ghostnet, and Shadownet. You can switch between them just by specifying the network in your request.

**Can I use TzKT MCP to audit smart contracts?**
Yes, it can pull Michelson code and storage. This makes it a powerful tool for developers who need to verify contract states during an audit.

**How do I get higher rate limits for the TzKT MCP?**
You can provide your TzKT API key in the configuration settings. This will allow your agent to perform more frequent queries without hitting limits.

**Can TzKT MCP show me token transfers?**
Yes, it lists FA1.2 and FA2 token transfers. You can ask your agent to track the movement of specific assets across the network.

**Can I use TzKT MCP to see network stats?**
Yes, it pulls network-wide stats like TPS and volume. It's a great way to monitor the health and activity level of the Tezos blockchain.

**Does TzKT MCP require a Tezos wallet?**
No, it just needs an API key to query the blockchain data. It's designed to pull public ledger information for your AI client.

**Can I see how an account's balance has changed over time?**
Yes! Use the `get_account_balance_history` tool with the account address. It will return a historical record of balance changes for that specific Tezos address.

**How do I check the current state or storage of a smart contract?**
You can use the `get_contract_storage` tool by providing the contract's KT1 address. This will retrieve the current data stored in the contract's state.

**Is it possible to list transactions for a specific sender or target?**
Absolutely. Use the `list_transactions` tool and apply filters like `sender` or `target` to narrow down the results to specific addresses or interaction flows.