# Scrollscan MCP for AI Agents AI Agent Connect

> Scrollscan MCP lets your AI agent pull real-time data from the Scroll L2 blockchain. You can check wallet balances, track specific token transfers like NFTs, and pull contract ABIs directly into your workflow. It turns your agent into a live on-chain data terminal for the Scroll ecosystem, removing the need to switch tabs or manually filter through block explorer results.

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

## Description

Connect to Scrollscan and bring real-time Scroll L2 blockchain data into your AI-powered workflows. If you're tired of switching tabs between your code editor and a block explorer, this Connector handles the heavy lifting. You can check wallet balances, track specific token movements like NFTs, and pull verified contract ABIs without leaving your chat or IDE. This tool is a key part of the Vinkius catalog, making it easy to plug into your existing setup. Instead of digging through a website to find a single transaction hash, you just ask your agent to find it for you. It pulls the raw data directly into your workflow, whether you're looking for ERC20 transfers, internal transaction logs, or block rewards. You stop being a data entry clerk for the blockchain and start actually analyzing the results. This means you can audit multiple addresses at once, verify contract source code, or monitor live gas prices with just a few words. It turns your AI into a live on-chain data terminal, letting you focus on the logic of your project rather than the tedious work of manual data collection. It's perfect for anyone who needs to see what's happening on the network in plain English without the friction of manual searching.

## Tools

### check_verify_status
See the current verification status of a specific smart contract. Use this to quickly check if a contract is public.

### get_account_balance_multi
Fetch Ether balances for a list of multiple addresses at once. This saves time when auditing several wallets simultaneously.

### get_account_balance
Get the current Ether balance for a single wallet address. This is the fastest way to check a specific account's holdings.

### get_block_number_by_time
Find the block number associated with a specific timestamp. This is useful for syncing historical data.

### get_block_reward
Look up the rewards distributed for a specific block number. This helps in analyzing network incentives.

### get_contract_abi
Retrieve the ABI for a verified contract to help with interaction. You can use this to understand how to call functions.

### get_contract_source_code
Pull the verified source code for a smart contract. This is great for deep-diving into a protocol's logic.

### get_erc1155_token_tx
Find all ERC1155 token transfer events for a specific address. Use this to track multi-token standards.

### get_erc20_token_tx
Track all ERC20 token transfers for a specific wallet. This helps you monitor stablecoins and other assets.

### get_erc721_token_tx
Monitor NFT (ERC721) transfers associated with an address. This is perfect for tracking high-value collectibles.

### get_eth_price
Get the current market price of Ether. Use this to pull live pricing into your analysis.

### get_eth_supply
Check the total supply of Ether on the Scroll network. This helps you understand the total circulating supply.

### get_internal_tx_list_by_block_range
Pull internal transactions that occurred within a specific block range. This is useful for auditing specific periods.

### get_internal_tx_list_by_hash
Find internal transactions linked to a specific transaction hash. Use this to trace complex multi-step moves.

### get_internal_tx_list
List all internal transactions for a specific wallet address. This helps identify hidden movements between contracts.

### get_logs
Retrieve raw logs from the blockchain. Use this for advanced debugging of contract events.

### get_mined_blocks
See a list of blocks mined by a specific address. This is useful for identifying active validators.

### get_normal_tx_list
Fetch a list of standard transactions for an address. Use this to see the general activity of a wallet.

### get_token_balance
Check the balance of a specific ERC20 token for an address. This lets you see how much of a specific asset a user holds.

### get_token_supply
Get the total supply of a specific ERC20 token. This is a quick way to check the total volume of a project.

### proxy_get_code
Get the bytecode of a smart contract. Use this when you need to see the compiled contract.

### proxy_get_storage_at
Read the storage value at a specific slot. This is a powerful way to inspect contract state.

### proxy_get_transaction_by_hash
Get full transaction details using a hash. Use this for a complete look at a specific on-chain move.

### proxy_get_transaction_receipt
Get the receipt for a specific transaction hash. This provides the final result of a transaction.

### verify_source_code
Check if a contract's source code is verified on Scrollscan. This helps you confirm the legitimacy of a smart contract.

### get_block_countdown
See how much time is left until the next block is mined. Use this to track the pace of the Scroll L2 network.

### get_tx_receipt_status
Check the status of a transaction receipt. Use this to see if a transaction succeeded or failed.

### get_tx_status
Verify the current status of a transaction. This gives you a quick yes or no on a recent move.

### proxy_block_number
Get the current block number using a proxy call. This is a low-level way to query the current state.

### proxy_call
Execute a call to a smart contract using the proxy method. This allows your agent to interact with contract data directly.

### proxy_estimate_gas
Estimate the gas required for a contract call. Use this to prevent out-of-gas errors during development.

### proxy_gas_price
Get the current gas price from the network. This helps you plan your next transaction cost.

### proxy_get_block_by_number
Fetch block data by its number via proxy. This provides deep access to historical block details.

## Prompt Examples

**Prompt:** 
```
What is the ETH balance of address 0x1234567890abcdef1234567890abcdef12345678?
```

**Response:** 
```
I've checked the balance for that address. It currently holds **1.25 ETH** on the Scroll L2 network.
```

**Prompt:** 
```
Show me the last 5 normal transactions for 0xabcdef...
```

**Response:** 
```
I've retrieved the transaction list. Here are the 5 most recent transactions:

| Hash | Block | Value |
| :--- | :--- | :--- |
| 0xabc... | 12345 | 0.5 ETH |
| 0xdef... | 12346 | 1.2 ETH |
| 0xghi... | 12347 | 0.1 ETH |
| 0xjkl... | 12348 | 2.0 ETH |
| 0xmno... | 12349 | 0.3 ETH |
```

**Prompt:** 
```
Get the ERC20 token transfer events for address 0x123... on contract 0x456...
```

**Response:** 
```
Searching for ERC20 transfers... I found several transfer events for that token contract associated with your address. 

**Recent Transfers:**
* **Amount:** 500.00
* **From:** 0x123... 
* **To:** 0x789... 
* **Status:** Success
```

## Capabilities

### Bulk wallet balance checks
Fetch the Ether balance for a list of multiple addresses in one request.

### Live gas price tracking
Get current network gas prices and block rewards instantly.

### NFT and token monitoring
Track ERC20, ERC721, and ERC1155 transfer events for any address.

### Smart contract inspection
Retrieve verified source code and ABIs for on-chain contracts.

### Internal transaction auditing
Query internal transaction logs by hash or block range.

### Real-time block data
Get block numbers, timestamps, and countdowns for the Scroll L2 network.

## Use Cases

### Debugging a failed swap
An engineer asks the agent to check the get_tx_status and get_internal_tx_list_by_hash to see exactly where a swap stalled.

### Whale portfolio audit
A researcher tracks a whale by asking the agent to list get_erc20_token_tx and get_erc721_token_tx for five different wallets.

### Contract logic research
A developer pulls the get_contract_source_code and get_contract_abi to understand a new protocol's logic without leaving their IDE.

### Market monitoring
An analyst asks for the get_eth_price and get_eth_supply every hour to track network inflation and market trends.

## Benefits

- Stop manual tab switching by using get_account_balance_multi to check dozens of wallets instantly.
- Debug faster by pulling verified ABIs with get_contract_abi directly into your coding environment.
- Track NFT movements without clicking through filters by using get_erc721_token_tx.
- Monitor gas trends and network health using get_eth_price and proxy_gas_price.
- Audit contract behavior by pulling raw logs with get_logs and get_internal_tx_list.

## How It Works

The bottom line is you get live Scroll L2 data without the manual copy-pasting.

1. Connect your Scrollscan API key to the Connector in your client settings.
2. Ask your agent to query specific data like wallet balances or transaction logs.
3. Receive formatted blockchain data directly in your chat or code editor.

## Frequently Asked Questions

**How can I check Scroll L2 balances with an AI agent?**
You can use this Connector to pull real-time balances for any wallet on the Scroll network. Your agent can check a single address or a whole list of them at once, giving you an instant view of holdings.

**Can Scrollscan MCP track NFT transfers?**
Yes, it can monitor ERC721 and ERC1155 token transfers. You can ask your agent to track specific NFT movements for any given wallet address.

**How do I get smart contract ABIs using Scrollscan?**
The Connector can pull verified ABIs for contracts on Scroll L2. This is great for developers who need to understand how to interact with a contract without manual searching.

**Can I see internal transactions on Scroll L2?**
Yes, the Connector provides tools to query internal transaction logs by address or transaction hash. This is helpful for tracing complex multi-step on-chain movements.

**Does Scrollscan MCP support ERC20 token data?**
It does. You can check specific token balances and monitor all ERC20 transfer events for any wallet on the Scroll L2 network.

**How do I check gas prices on Scroll L2?**
You can ask your agent to pull the current gas price or the block reward. It gives you real-time network stats so you can plan your next transaction.

**How do I check the balance of multiple wallets at once?**
You can use the `get_account_balance_multi` tool. Simply provide a comma-separated list of addresses, and the agent will return the Ether balance for each one in a single request.

**Can I track NFT transfers for a specific address?**
Yes! Use the `get_erc721_token_tx` tool for standard NFTs or `get_erc1155_token_tx` for multi-token standards. Provide the wallet address and the contract address to see all relevant transfer events.

**How do I get the ABI for a verified contract?**
Use the `get_contract_abi` tool with the target contract address. If the source code is verified on Scrollscan, the agent will retrieve the complete ABI for you.