# IoTeX MCP for AI Agents AI Agent Connect

> IoTeX MCP connects your AI agent to the IoTeX blockchain to pull real-time network data. It lets you query account balances, transaction histories, block data, and token details directly through your chat interface. Stop manually digging through web explorers and start getting live data instantly.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_uf7FWJCYEdHc7dZYspdM00lNFsp7Ox3HGLZtw794/ai-agent-connect
- **Tags:** iotex, block-explorer, web3, crypto-data, blockchain-api

## Description

IoTeX MCP connects your AI agent to the IoTeX blockchain to pull real-time network data. Usually, checking blockchain data is a chore. You have to copy an address, open a new tab, wait for a web explorer to load, and then hunt for the specific transaction or token detail you need. It breaks your flow and wastes time. This Connector puts that data directly into your conversation. Ask your agent about a wallet's balance, a specific block's height, or a token's holder list, and it pulls the info instantly. It turns your agent into a dedicated blockchain analyst that can handle live data on the fly. Whether you are debugging a smart contract or doing deep-dive research on a new project, having this data available in your chat makes everything move faster. By using Vinkius, you can connect your preferred AI client once and get this IoTeX tool along with access to a catalog of over 4,000 other Connectors. This means you stop hunting for info and start using it. Get the data you need without the tab-switching. It makes the difference between searching and knowing. Monitor network pulses, verify transaction statuses, and gather token metadata with just a few words. It removes the extra steps of manual data entry and lets you focus on the actual work of building or analyzing.

## Tools

### get_account_actions
get_account_actions pulls the full transaction history for a specific wallet address. It works well for auditing past activity.

### get_account
get_account fetches the current balance, nonce, and metadata for any IoTeX address. Use it for quick wallet checks.

### get_action
get_action looks up the specific details of a transaction using its unique hash. It works for debugging a single failed event.

### get_block_by_hash
get_block_by_hash pulls the data for a specific block using its unique hash. It provides a way to perform deep-dive audits of the chain.

### get_block_by_height
get_block_by_height gets the contents of a block based on its position in the chain. It works well for sequential data analysis.

### get_recent_actions
get_recent_actions lists the latest transactions happening on the network in real time. Use it to monitor live network pulses.

### get_token_holders
get_token_holders pulls a list of all addresses holding a specific token. This helps you see how a token's supply is distributed.

### get_token
get_token fetches the metadata for XRC20 or XRC721 tokens. Use it to check total supply and decimal counts.

## Prompt Examples

**Prompt:** 
```
What's the balance of this wallet: io1prv56hmvfm08z6p6v6v6v6v6v6v6v6v6v6v6v6.
```

**Response:** 
```
### Wallet Details
**Address:** `io1prv56hmvfm08z6p6v6v6v6v6v6v6v6v6v6v6v6.`

| Metric | Value |
| :--- | :--- |
| **Balance** | 1,250 IOTX |
| **Nonce** | 42 |

I've pulled the latest data for this account. Would you like to see the recent transaction history for this address?
```

**Prompt:** 
```
Show me the latest 5 transactions on the IoTeX network.
```

**Response:** 
```
### Recent Network Activity
I've pulled the most recent actions on the network:

* **Transfer:** 500 IOTX at block `31054201`
* **Contract Execution:** `0x7a...`
* **Transfer:** 120 IOTX at block `31054202`
* **Contract Execution:** `0x1b...`
* **Transfer:** 50 IOTX at block `31054203`
```

**Prompt:** 
```
Tell me about the token at this address: io1hp6y4...
```

**Response:** 
```
### Token Metadata
**Name:** MachineFi (MFI)

* **Total Supply:** 1,000,000,000
* **Decimals:** 18
* **Standard:** XRC20

Would you like me to list the current top holders for this token?
```

## Capabilities

### Pull account balances and nonces
Get a wallet's current balance and nonce with a single request.

### List transaction history
View every action associated with a specific wallet address.

### Inspect specific transactions
See the details of a single transaction using its unique hash.

### Query block data
Fetch all information for a specific block by its hash or height.

### Monitor network activity
See the latest actions happening on the network in real time.

### Retrieve token metadata
Get details like total supply and decimals for XRC20 or XRC721 tokens.

### List token holders
See the distribution of a token by listing all its current holders.

## Use Cases

### Debugging a failed transaction
A developer asks the agent to check a specific hash using `get_action` to see why a transfer didn't complete. The agent pulls the raw data and explains the status.

### Conducting a token audit
An analyst uses `get_token` and `get_token_holders` to see the total supply and who owns the most tokens to determine a project's distribution.

### Checking a new wallet
A user wants to see if a specific address has received funds, so they use `get_account` to see the balance and recent activity.

### Tracking network growth
A researcher asks for `get_recent_actions` to see how many transactions are happening on the IoTeX network in the last few minutes.

## Benefits

- Stop context-switching between your IDE and a web explorer by using `get_account` to check balances instantly. This keeps you in your code and gives you the data you need without opening new tabs.
- Audit wallet histories faster by pulling full transaction lists with `get_account_actions` instead of clicking through multiple pages on a website.
- Get precise token metadata for XRC20 assets immediately using `get_token` to verify supply and decimals without manual lookups.
- Analyze token distribution in seconds by listing all holders with `get_token_holders` via a simple chat prompt to see who owns the most.
- Monitor live network pulses with `get_recent_actions` to stay updated on the latest transactions without having to refresh browser tabs constantly.

## How It Works

The bottom line is you get real-time IoTeX blockchain data inside your AI chat instead of hunting through web explorers.

1. Subscribe to the IoTeX MCP through the Vinkius catalog.
2. Add your IoTeX API key if you need to bypass standard rate limits.
3. Ask your AI client to check a wallet balance, block, or token holder list.

## Frequently Asked Questions

**Can I use the IoTeX MCP to check my wallet balance?**
Yes, you can ask your AI agent to pull the current balance and nonce for any IoTeX address instantly without leaving your chat.

**Does the IoTeX MCP work for XRC20 tokens?**
Yes, it can fetch specific metadata like total supply and decimals for XRC20 and XRC721 tokens.

**Can I see recent network activity with IoTeX MCP?**
Yes, your agent can pull the latest transactions and network actions to show you what is happening on the chain right now.

**Do I need an API key for the IoTeX MCP?**
It is optional. You can use it without a key, but adding your IoTeX API key allows for higher rate limits for more frequent queries.

**How does IoTeX MCP help with research?**
It allows you to quickly pull token holder lists and block data, making it much easier to gather information for market research or audits.

**Is the IoTeX MCP only for the IoTeX blockchain?**
Yes, this Connector is specifically designed to provide deep access to the IoTeX network's blockchain data.

**How can I see the transaction history for a specific IoTeX address?**
You can use the `get_account_actions` tool. Simply provide the IoTeX address, and the agent will return a list of recent actions (transactions) associated with that account.

**Can I look up block details if I only have the block height?**
Yes! Use the `get_block_by_height` tool and provide the numeric height. The agent will fetch the full block details including hash, timestamp, and transaction count.

**Is it possible to see who the top holders of a specific token are?**
Yes, by using the `get_token_holders` tool with the token's contract address, you can retrieve a list of addresses that currently hold that specific XRC20 or XRC721 token.