# Blockscout MCP for AI Agents AI Agent Connect

> Blockscout lets you query Ethereum-based blockchains directly from your AI agent. You can pull wallet balances, track token holdings, and inspect transaction details or smart contract data using Blockscout's open-source API. It turns your AI into a real-time blockchain data explorer.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_hlcY2pw6zKczmbd2yWRf1qbVzxzUrs93dFPdt3Tl/ai-agent-connect
- **Tags:** ethereum, block-explorer, smart-contracts, web3, crypto-api

## Description

Imagine you're digging into a complex on-chain movement. Instead of opening a dozen tabs and manually copying hex codes from a block explorer, you can just ask your AI agent to do the heavy lifting. This Connector connects your agent to Blockscout, giving it the eyes it needs to see what's happening on the chain in real-time. You can have it audit wallet balances, list every token in a portfolio, or pull the exact source code for a smart contract without leaving your chat window. It's about getting the data you need to make decisions, whether you're debugging a failed transaction or tracking a whale's movements. By adding this to your setup on Vinkius, you get a direct pipeline to deep on-chain metrics. It moves the work from manual searching to natural language queries. You get the facts, and you get them fast.

## Tools

### get_account_transactions
List all transactions for a specific address. Use this to see a wallet's full history.

### get_contract_source_code
Pull the source code for a smart contract. This helps you verify logic without leaving your chat.

### get_logs
Fetch event logs for a contract. This is perfect for auditing specific on-chain events.

### get_token
Get the core information for a specific token. Use this to quickly identify token properties.

### get_total_supply
Find the total supply of a native coin. This helps you understand the current circulating supply.

### get_transaction
Retrieve full details for a specific transaction hash. Use this to debug failed swaps or transfers.

### json_rpc
Execute a standard Ethereum JSON-RPC 2.0 method. This gives you raw access to the blockchain.

### list_token_balances
List all tokens held by an address. Use this to see a full portfolio in one go.

### get_address
Pull specific details for a wallet or contract address. Use this for quick identity checks.

### get_block
Get the metadata for a specific block. Use this to see miner fees and timestamps.

### get_contract_abi
Get the ABI for a smart contract. This is essential for interacting with the contract via code.

### get_indexing_status
Check if the explorer is up to date. Use this to ensure your data is current.

### get_account_balance
Get the native balance for a specific address. Use this for quick wealth checks.

### get_account_internal_transactions
Find internal transactions for an address. Use this to trace complex multi-step transfers.

## Prompt Examples

**Prompt:** 
```
What is the balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e?
```

**Response:** 
```
I've pulled the data for that address. Here is the current status:

| Asset | Balance |
| :--- | :--- |
| **ETH** | 1,245.00 |
| **USDT** | 500.00 |
| **LINK** | 10.5 |

**NFT Holdings:**
* 2 NFTs from the 'Bored Ape Yacht Club' collection.
```

**Prompt:** 
```
Check the gas used for transaction 0x5c504ed432cb511de36b21cdd8187727a1714170f96219109512ee1000673974.
```

**Response:** 
```
The transaction was **successful**. Here are the details:

* **Status:** Confirmed
* **Gas Used:** 21,000 units
* **Total Fee:** 0.000441 ETH
* **Block:** 12,345,678

Everything looks correct with the gas consumption for this move.
```

**Prompt:** 
```
Does this contract have a total supply?
```

**Response:** 
```
I've checked the contract details. The total supply for the native coin on this chain is currently **150,000,000**. 

Would you like me to check the distribution or look for specific whale holdings?
```

## Capabilities

### Audit wallet balances
Fetch native balances and transaction counts for any address instantly.

### Track token portfolios
List all ERC-20, ERC-721, and ERC-1155 tokens held by a specific wallet.

### Inspect transaction details
Get gas usage, status, and decoded input data for any transaction hash.

### Monitor network health
Retrieve block metadata and check the explorer's current indexing status.

### Access smart contract data
Pull verified contract ABIs and source code directly from the explorer.

### Query JSON-RPC methods
Execute standard Ethereum JSON-RPC 2.0 methods through your agent.

## Use Cases

### Debugging a failed swap
A dev asks the agent to check a transaction hash. The agent uses get_transaction to find the gas error and explains it.

### Whale tracking
An analyst asks for all tokens held by a specific address. The agent uses list_token_balances to show the full portfolio.

### Contract verification
A dev wants to see the logic of a new contract. The agent uses get_contract_source_code to display the verified code.

### Portfolio summary
A user asks for their current balance. The agent uses get_account_balance and list_token_balances to give a complete overview.

## Benefits

- Skip the manual searching by pulling wallet balances and transaction history directly into your chat using get_account_balance and get_account_transactions.
- Audit full token portfolios instantly with list_token_balances so you don't have to click through multiple explorer pages.
- Debug smart contracts faster by pulling source code and ABIs using get_contract_source_code and get_contract_abi.
- Get precise transaction data including gas usage and decoded inputs with get_transaction to troubleshoot failed interactions.
- Track complex movements with get_account_internal_transactions to see how funds move between contracts.
- Stay updated on network status by checking the explorer's indexing with get_indexing_status.

## How It Works

The bottom line is you get a direct, natural language interface for deep blockchain data without the manual searching.

1. Subscribe to the Blockscout MCP on Vinkius.
2. Input your preferred Blockscout instance URL and your API key.
3. Ask your AI client to fetch balances, tokens, or transaction history.

## Frequently Asked Questions

**Can Blockscout MCP help me track my crypto portfolio?**
Yes, it can list balances for various tokens in one view. This lets you see your entire portfolio without clicking through different explorer pages.

**How do I use Blockscout MCP to check transaction status?**
Just provide the transaction hash to your agent. It will retrieve the status, gas usage, and decoded input data automatically.

**Can I use Blockscout MCP for different blockchains?**
Yes, it works with any Blockscout instance. You can connect it to various Ethereum-based chains by providing the correct base URL.

**Can my agent see smart contract source code with Blockscout?**
Yes, it can pull verified source code and ABIs directly. This is great for developers who need to audit logic quickly.

**Is Blockscout MCP good for auditing internal transfers?**
Yes, it includes a tool specifically for finding internal transactions. This helps you trace how funds move between different contracts.

**How does Blockscout MCP handle different token types?**
It supports retrieving balances for ERC-20, ERC-721, and ERC-1155 tokens, giving you a complete picture of a wallet's holdings.

**Can I see all the different tokens owned by a specific wallet address?**
Yes. By using the `list_token_balances` tool with the wallet's address hash, the agent will return a comprehensive list of all ERC-20, ERC-721, and ERC-1155 tokens associated with that account.

**Is it possible to check if the Blockscout explorer is fully updated with the latest chain data?**
Absolutely. You can use the `get_indexing_status` tool to check the synchronization progress, including the indexing ratios for blocks and internal transactions.

**Can I retrieve the ABI of a verified smart contract to interact with it?**
Yes, for verified contracts, you can use the `get_contract_abi` tool. This provides the Application Binary Interface required for decoding transactions or making contract calls.