# Arbiscan MCP for AI Agents AI Agent Connect

> Arbiscan (Arbitrum Explorer) MCP lets your AI agent pull live data from the Arbitrum L2 network. You can check balances, track complex transaction histories, and inspect smart contract source code without switching tabs. It's built for anyone who needs real-time blockchain transparency directly within their chat or IDE.

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

## Description

When you're digging into the Arbitrum network, you usually have to jump between a block explorer, a wallet dashboard, and your code editor. This Connector changes that by bringing the data directly to where you're already working. Instead of copy-pasting hex strings or hunting for contract ABIs, you just ask your agent to show you what's happening on-chain. You can see exactly how much ETH is sitting in a specific wallet, trace how funds moved through internal calls, or grab the verified source code for a dApp you're currently debugging. It handles the heavy lifting of querying the L2, so you can stay focused on the analysis. Whether you're hunting for whale movements or trying to understand a new protocol's logic, this connection gives your agent the eyes it needs to see the Arbitrum blockchain in real-time. It's a core part of the Vinkius catalog, designed to bridge the gap between raw blockchain data and actionable insights. You get to move faster because the data is finally where you need it.

## Tools

### get_abi
Fetches the ABI for verified source codes. This helps you understand the functions available in a specific smart contract.

### get_balance_multi
Retrieves the Ether balance for multiple addresses in one go. It's great for auditing several wallets simultaneously.

### get_balance
Retrieves the Ether balance for a single address. This is the quickest way to check a specific wallet's holdings.

### get_block_countdown
Provides the estimated time until the next block. Use this to track the progression of the network.

### get_block_reward
Shows the rewards for a specific block number. This helps in understanding network incentives.

### get_eth_price
Returns the most recent price for Ether on Arbitrum. It keeps your agent updated on current market values.

### get_eth_supply
Shows the total supply of Ether on the Arbitrum network. Use this for high-level network analysis.

### get_logs
Retrieves event logs from the blockchain. This is useful for tracking specific contract events.

### get_status
Checks the execution status of a contract. It tells you if a contract is currently active or has stopped.

### get_token_nft_tx
Lists ERC721 token transfer events for an address. Use this to track NFT movements across the network.

### get_token_tx
Lists ERC20 token transfer events for an address. This lets you monitor specific token flows like USDC or USDT.

### get_tx_list_internal
Pulls a list of internal transactions for a specific address. Use this to see how funds move between contracts behind the scenes.

### get_tx_list
Lists normal transactions for a given address. This gives you a clear view of standard on-chain activity.

### get_tx_receipt_status
Checks the status of a specific transaction receipt. Use it to see if a transfer actually succeeded or failed.

### verify_source_code
Submits and verifies contract source code through the API. This is essential for making your code publicly readable on the explorer.

### get_source_code
Fetches the verified source code for a contract. You can use this to study the logic of a dApp directly.

## Prompt Examples

**Prompt:** 
```
Check the balance of 0x123... and tell me the current ETH price.
```

**Response:** 
```
I've pulled the latest data from the Arbitrum network for you:

| Address | Balance | 
| :--- | :--- | 
| 0x123... | 1,450.25 ETH |

**Current Market Info:**
* **ETH Price:** $2,450.12
* **Network:** Arbitrum L2
```

**Prompt:** 
```
Show me the last 5 NFT transfers for this address.
```

**Response:** 
```
I've retrieved the recent ERC721 transfers for that wallet:

* **Transfer 1:** 1.0 Bored Ape Yacht Club to 0xabc... (12:04 PM)
* **Transfer 2:** 1.0 CryptoPunks to 0xdef... (11:45 AM)
* **Transfer 3:** 1.0 Azuki to 0xghi... (10:30 AM)
* **Transfer 4:** 1.0 Pudgy Penguins to 0xjkl... (09:15 AM)
* **Transfer 5:** 1.0 DeGods to 0xmno... (08:00 AM)
```

**Prompt:** 
```
What's the source code for the contract at 0x456...?
```

**Response:** 
```
I've fetched the verified source code for that contract. Here is the beginning of the implementation:

```solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0; 

contract ExampleContract {
    function main() public view returns (uint256) {
        return 100;
    }
    // ... [remaining code] ...
}
```
```

## Capabilities

### Check balances for multiple addresses
Retrieve the Ether balance for several wallets in a single request.

### Track ERC20 and ERC721 transfers
Monitor specific token and NFT movements across the Arbitrum network.

### Pull verified smart contract source code
Get the actual code for verified contracts to study their logic.

### Get real-time ETH prices and supply
Fetch current market prices and total supply data for Arbitrum.

### Verify contract source code
Submit and verify your own contract source code through the API.

### View internal transaction history
See hidden internal calls to understand how funds move between contracts.

## Use Cases

### Whale Tracking
An analyst asks the agent to find all large USDC movements from a specific whale address. The agent uses get_token_tx and get_tx_list_internal to summarize the activity.

### Smart Contract Debugging
A developer wants to know why a contract is failing. They ask the agent to pull the ABI and source code using get_abi and get_source_code to find the bug.

### Security Audit
A researcher wants to check for suspicious activity. They ask the agent to list all transactions and internal calls using get_tx_list and get_tx_list_internal for a target address.

### Portfolio Overview
A user wants a quick summary of their assets. The agent uses get_balance_multi and get_eth_price to provide a real-time valuation of several wallets.

## Benefits

- Stop tab-switching by getting Arbitrum balances and prices directly in your chat or IDE using get_balance and get_eth_price.
- Audit multiple wallets at once with get_balance_multi to save time on manual data entry.
- Trace complex fund movements including internal calls with get_tx_list_internal for deeper security analysis.
- Study dApp logic faster by pulling verified source code and ABIs with get_source_code and get_abi.
- Monitor NFT and token flows easily using get_token_nft_tx and get_token_tx to track specific assets.
- Verify your own smart contracts through the agent using verify_source_code to maintain transparency.

## How It Works

The bottom line is you get instant access to Arbitrum blockchain data without ever leaving your primary workspace.

1. Subscribe to the Connector and enter your Arbiscan API Key.
2. Connect the Connector to your preferred AI client like Claude or Cursor.
3. Ask your agent to fetch specific Arbitrum data using natural language.

## Frequently Asked Questions

**Can Arbiscan MCP check balances on Ethereum mainnet?**
No, this Connector is specifically for the Arbitrum L2 network. You'll need a different tool for mainnet data.

**Can I use Arbiscan MCP to track my NFT sales?**
Yes, it can pull ERC721 transfer events for any address so you can see your sales history.

**How do I get the source code for a dApp?**
Just ask your agent to fetch the verified source code for a specific contract address using this Connector.

**Can it track internal transactions?**
Yes, it can pull internal calls which are often hidden in standard transaction lists.

**Does Arbiscan MCP show real-time prices?**
It can fetch the most recent Ether price on the Arbitrum network for your queries.

**Can I verify my own smart contracts?**
Yes, the Connector includes tools to submit and verify your source code through the Arbiscan API.

**Can I check the balances of multiple Arbitrum addresses at once?**
Yes! Use the `get_balance_multi` tool and provide a comma-separated list of addresses. The agent will return the Ether balance for each one in a single response.

**How do I view the source code of a verified smart contract?**
Simply provide the contract address to the `get_source_code` tool. If the contract is verified on Arbiscan, your agent will retrieve the full source code for you to inspect.

**Can I track NFT (ERC721) transfers for a specific wallet?**
Yes, the `get_token_nft_tx` tool allows you to list ERC721 token transfer events associated with any Arbitrum address, including block numbers and transaction hashes.