# Blockscout MCP

> Blockscout lets your AI agent run deep, real-time analysis on any Ethereum-based blockchain directly from chat or IDE. It queries native balances, tracks complex token portfolios (ERC-20, ERC-721), and inspects raw transaction data. Use it to audit addresses, verify contract source code, and pull block metadata without leaving your workflow.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** ethereum, block-explorer, smart-contracts, web3, crypto-api

## Description

This MCP connects any Blockscout explorer instance straight into your AI agent, giving you deep on-chain insight for crypto analysis. You can instantly fetch native balances, check how many transactions an address has run through, or list every single token it holds—all with one prompt. Need to understand a specific transaction? Get its detailed status, gas usage, and decoded input data right away. It’s also perfect for devs who need to pull contract ABIs or source code directly from their IDE. If you use Vinkius, you get access to this specialized tool alongside thousands of others, keeping your entire crypto stack connected in one place.

## Tools

### get_account_balance
Retrieves the native cryptocurrency balance associated with a given address.

### get_account_internal_transactions
Lists internal transactions that occurred through an account address.

### get_account_transactions
Fetches the complete transaction history for a specific wallet or contract address.

### get_address
Retrieves general metadata and details about a blockchain address.

### get_block
Gets the comprehensive data set for an entire block, including its miner and timestamp.

### get_contract_abi
Retrieves the Application Binary Interface (ABI) used by a specific smart contract.

### get_contract_source_code
Fetches the actual source code that was deployed for a smart contract.

### get_indexing_status
Checks the current indexing status of the connected block explorer.

### get_logs
Retrieves event logs, which are key signals about interactions happening on-chain.

### get_token
Provides general information and metadata for a specific token contract address.

### get_total_supply
Calculates and returns the total available supply of the native coin or token.

### get_transaction
Gets all detailed data points for a single transaction hash, including gas costs.

### json_rpc
Allows execution of any standard Ethereum JSON-RPC 2.0 method directly via the agent.

### list_token_balances
Lists all ERC-20, ERC-721, and ERC-1155 token balances held by an address.

## Prompt Examples

**Prompt:** 
```
Get the balance and ENS name for address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
```

**Response:** 
```
I've retrieved the details for that address. It currently holds 1,245 ETH, is associated with the ENS name 'vitalik.eth', and has a total of 12,432 transactions.
```

**Prompt:** 
```
List all token balances for 0x742d35Cc6634C0532925a3b844Bc454e4438f44e.
```

**Response:** 
```
I found several tokens in this wallet. It holds 500 USDT, 10.5 LINK, and 2 NFTs from the 'Bored Ape Yacht Club' collection. Would you like more details on a specific token?
```

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

**Response:** 
```
Transaction 0x5c50... was successful. It was included in block 12,345,678 and used 21,000 gas units with a total fee of 0.000441 ETH.
```

## Capabilities

### Audit Wallet Holdings
Determine an address's native coin balance, total transaction count, and list all associated token holdings.

### Analyze Transactions
Retrieve detailed information on a specific transaction hash, including gas used and success status.

### Inspect Contracts
Access contract source code and verified ABIs to understand how smart contracts actually work.

### Query Network Status
Get block metadata, check the overall network indexing health, or execute standard Ethereum JSON-RPC methods.

## Use Cases

### Investigating a suspicious wallet
A user needs to know if a competitor's wallet (0xABC...) is liquidating assets. They ask their agent, and it uses `get_account_transactions` and `list_token_balances` to immediately pull the last 50 transactions and show exactly which tokens were dumped.

### Verifying contract compliance
A developer needs to confirm that a new protocol adheres to standard token rules. They use `get_contract_abi` and `get_total_supply` on the target contract, confirming its function signatures and overall supply cap.

### Building an internal dashboard metric
A data analyst needs a daily report showing total asset movement. They prompt the agent to use `get_account_internal_transactions` across 10 key addresses, collecting all necessary metrics in one go for their spreadsheet.

### Debugging an unexpected transaction
A user sees a failed transfer and needs to know why. They input the hash into the agent, which uses `get_transaction` to retrieve the full status, gas usage, and decoded data for review.

## Benefits

- Audit holdings instantly: Instead of visiting multiple tabs to check balances, simply ask the agent to list token balances for an address using `list_token_balances` and get a full picture immediately.
- Debug smart contracts easily: Developers can use `get_contract_abi` and `get_contract_source_code` to verify contract logic without switching to their IDE or running local simulations.
- Track activity history: Quickly review an address's entire journey by fetching its transaction record using `get_account_transactions`, providing a clear audit trail for any wallet.
- Understand raw data flow: For debugging, use `get_logs` to capture event logs. This shows precisely what happened during a function call that simple balance checks miss.
- Query anything: The integrated `json_rpc` tool means you can execute standard Ethereum RPC calls—it's your Swiss Army knife for blockchain metrics.
- View network health: Check the status of the explorer itself with `get_indexing_status`, ensuring your data source is up-to-date and reliable.

## How It Works

The bottom line is you get a direct, structured pipeline to deep blockchain metrics without leaving your conversational interface.

1. First, subscribe to this MCP and provide the Base URL for your preferred Blockscout instance (like `https://eth.blockscout.com`).
2. Next, give your AI client permission to run queries against that specific blockchain endpoint.
3. Finally, tell your agent exactly what you need—for example, 'What is the total supply of this token?' or 'Show me all tokens for address X.' The data comes back instantly.

## Frequently Asked Questions

**How do I check the total supply with Blockscout MCP?**
You use `get_total_supply` to pull this metric directly from your agent. It calculates and returns the current circulating or capped supply for a given token contract.

**Is Blockscout MCP better than using Etherscan manually?**
Yes, because it integrates that data into your existing chat workflow. Instead of leaving the conversation to check transactions via `get_account_transactions`, you get the result immediately in context.

**Can I use Blockscout MCP for anything other than ETH?**
The API supports various chains, but it’s designed around Ethereum standards. For specific data points, running `json_rpc` allows you to target different network methods.

**What is the difference between getting an account balance and listing token balances?**
Getting the account balance checks for native coins (like ETH). Listing tokens uses `list_token_balances` to find all non-native, ERC-20 type assets held by that address.

**Can I debug a transaction using Blockscout MCP?**
Absolutely. You provide the hash, and the agent uses `get_transaction` to retrieve detailed status information, including gas usage and success flags for debugging.