# Aptoscan MCP for AI Agents AI Agent Connect

> Aptoscan MCP lets your AI agent talk directly to the Aptos blockchain. You can pull account balances, check transaction history, and look up NFT data without leaving your chat window. It turns your agent into a real-time blockchain explorer for the Aptos network.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_AJDAKtI9KbTNthRPjchKPh8F2JivrqoEQtxbJRTs/ai-agent-connect
- **Tags:** aptos, blockchain-explorer, web3, smart-contracts, nft-tracking

## Description

Imagine you're trying to track a whale's movements or debug a complex smart contract interaction on Aptos. Usually, this means jumping between tabs, copying wallet addresses, and squinting at explorer pages to find a specific transaction hash. It's a fragmented process that breaks your focus. This Connector changes that by giving your agent a direct line to the ledger. Instead of hunting for data, you just ask your agent to show you what's happening. You can pull up specific account details, see exactly what resources a wallet holds, or dig into the Move modules that power the network. It's a massive shortcut for anyone who needs to see what's actually happening on-chain in real-time. Because Vinkius hosts this in their catalog, you can plug it into your existing setup and start querying the blockchain immediately. It takes the manual labor out of data gathering, whether you're auditing a new project or just keeping tabs on your own portfolio. You get the raw data you need, formatted exactly how you want it, without the middleman of a browser window.

## Tools

### get_account_resources
List all resources owned by an account. Use this to see the full state of a wallet's holdings.

### get_account_tokens
Pull a list of all tokens, including NFTs and fungible assets, for a given address. It's the fastest way to audit a wallet's collection.

### get_account_transactions
Fetch a list of transactions tied to a specific account. Use this to trace the history of a particular wallet.

### get_block_by_version
Retrieve block details using a specific transaction version. Use this when you need to find a block based on a known event.

### get_token_data
Fetch metadata and supply information for a specific token. It helps you see the core details of any asset on the network.

### get_transaction_by_hash
Get the full details of a transaction using its unique hash. This is the go-to for debugging specific on-chain movements.

### get_transaction_by_version
Retrieve transaction details using its ledger version. Use this to find specific events in the blockchain history.

### get_account_balance
Check the current balance of any Aptos account. This helps you quickly see how much APT a wallet holds.

### get_account_modules
See all Move modules published under a specific address. It's great for understanding a project's smart contract footprint.

### get_block_by_height
Get the details of a block at a specific height. This is useful for auditing network activity at a specific point in time.

## Prompt Examples

**Prompt:** 
```
What's the current balance of the Aptos account 0x1?
```

**Response:** 
```
I'll check that for you. 

**Account Details for 0x1:**
* **Balance:** 100,000,000 APT
* **Status:** Active

Let me know if you'd like to see the transaction history for this address as well.
```

**Prompt:** 
```
List the last 5 transactions for address 0xeeff...8899.
```

**Response:** 
```
Fetching the recent history for that wallet...

| Version | Type | Status | Timestamp |
| :--- | :--- | :--- | :--- |
| 123456789 | User Transaction | Success | 2023-05-25 14:02 |
| 123456788 | Transfer | Success | 2023-05-25 13:55 |
| 123456787 | Move Call | Success | 2023-05-25 13:40 |
| 123456786 | Transfer | Success | 2023-05-25 13:30 |
| 123456785 | User Transaction | Success | 2023-05-25 13:20 |
```

**Prompt:** 
```
Give me the details for block height 5000000.
```

**Response:** 
```
Querying block 5000000...

**Block Summary:**
* **Height:** 5,000,000
* **Timestamp:** 1690000000
* **Transaction Count:** 45
* **Status:** Finalized

Would you like to see the specific transactions included in this block?
```

## Capabilities

### Pull account balances
Get the current APT balance for any specific wallet address instantly.

### Check transaction history
Retrieve a full list of past transactions for any account.

### Audit block data
Inspect specific blocks by height or transaction version.

### List account tokens
See all NFTs and fungible assets held by a specific wallet.

### Inspect Move modules
View all Move modules published under a specific account.

### Fetch token metadata
Get supply info and metadata for specific tokens on the network.

## Use Cases

### Debugging a failed transaction
A developer asks the agent to check a specific hash. The agent uses get_transaction_by_hash to find the exact error point.

### Whale tracking
An analyst asks for the last 10 transactions of a known whale. The agent pulls the data using get_account_transactions.

### NFT auditing
A collector wants to see every NFT in a specific wallet. The agent uses get_account_tokens to list them all.

### Smart contract research
A dev wants to see what modules an address has published. The agent uses get_account_modules to show the list.

## Benefits

- Stop manual tab switching by using get_account_transactions to see wallet history instantly.
- Audit smart contracts faster by pulling Move modules with get_account_modules directly into your chat.
- Track NFT collections without a browser by using get_account_tokens to list all assets.
- Debug specific on-chain events quickly with get_transaction_by_hash for precise data.
- Get instant wallet snapshots by pulling balances and resources with get_account_balance and get_account_resources.

## How It Works

The bottom line is you get real-time blockchain data directly in your chat interface.

1. Subscribe to the Aptoscan MCP via the Vinkius catalog.
2. Add your Aptoscan API key to your configuration.
3. Ask your agent to query the Aptos ledger for balances, blocks, or tokens.

## Frequently Asked Questions

**Can I use Aptoscan MCP to track NFT collections?**
Yes. You can ask your agent to list all tokens for any specific address, and it will pull the full collection of NFTs and fungible assets directly into your chat.

**How does Aptoscan MCP help with debugging smart contracts?**
It allows you to inspect Move modules published under an account and pull specific transaction details via hashes, making it much faster to find where a contract interaction failed.

**Can I check specific transaction hashes with Aptoscan MCP?**
Absolutely. You can provide a transaction hash to your agent, and it will retrieve the full details, including the ledger version and execution status.

**Is Aptoscan MCP good for monitoring whale wallets?**
It is ideal for this. You can quickly query the transaction history of any high-value address to see recent movements and token transfers in real-time.

**How do I get account balances using Aptoscan MCP?**
Just ask your agent for the balance of any Aptos address. It will query the ledger and give you the current APT balance immediately.

**Can Aptoscan MCP show me the Move modules on an account?**
Yes, it can retrieve all Move modules published under a specific address, which is helpful for understanding a project's on-chain footprint.

**How do I check the balance of a specific Aptos wallet?**
Use the `get_account_balance` tool by providing the Aptos account address. The agent will return the current balance of that account immediately.

**Can I see all NFTs and tokens owned by an address?**
Yes! The `get_account_tokens` tool lists all tokens, including NFTs and Fungible Assets, associated with a specific Aptos address.

**How can I look up the details of a transaction if I have the hash?**
Simply use the `get_transaction_by_hash` tool with the transaction hash. It will retrieve full details including status, sender, and payload.