# Bobascan MCP for AI Agents AI Agent Connect

> Bobascan MCP lets your AI agent interact directly with the Boba L2 Network. You can pull real-time balances, scan transaction histories, and pull verified smart contract source code or ABIs without leaving your workspace. It turns your agent into a blockchain analyst that can handle everything from checking gas prices to auditing complex DeFi interactions on the Boba chain.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_DDxcximY2oDXK4bVdvInoDMXA8dRfH3XE3hjBMFa/ai-agent-connect
- **Tags:** boba-network, layer-2, ethereum, block-explorer, smart-contracts

## Description

Stop jumping between multiple explorer tabs and copy-pasting hex codes into your terminal. This Connector puts the Boba Network's data directly into your agent's hands. You can ask for a wallet's full history, check the supply of a specific token, or pull the ABI for a contract you're trying to debug. It's about moving from searching for data to just getting it. Because Vinkius hosts this in their catalog, you can plug it into your existing setup and start querying the chain immediately. Whether you're auditing a new dApp or just want to keep an eye on your portfolio's movements, your agent handles the heavy lifting of fetching the right blocks and logs. You can use it to monitor network health, verify transaction receipts, or perform low-level JSON-RPC calls to test contract logic. It removes the friction of manual blockchain research and lets you focus on the actual analysis.

## Tools

### proxy_block_number
Get the current block number via JSON-RPC. This is good for low-level chain tracking and scripts.

### get_block_countdown
Get the estimated time until the next block is produced. This helps with timing sensitive transactions.

### get_block_reward
Find the reward amount for a specific block number. Use this to analyze network incentives.

### get_ether_balance
Get the balance for one specific address. This is a quick way to check individual holdings.

### get_logs
Fetch logs from the blockchain. Use this to see specific event emissions from smart contracts.

### get_source_code
Pull verified source code from a contract. This is perfect for security audits and deep dives.

### get_token_balance
Check an ERC20 token balance for a specific address. It is essential for multi-asset portfolio tracking.

### get_token_nft_tx
List ERC721 transfer events for a wallet. Track NFT movements easily without extra steps.

### get_token_supply
Get the total supply for an ERC20 token. Use this to understand the tokenomics of a project.

### get_token_tx
List all ERC20 transfer events for an address. See every token movement in one place.

### get_tx_list_internal
Pull internal transactions for a wallet. See how tokens move between contracts behind the scenes.

### get_tx_list
List all normal transactions for a wallet. Get a full history of on-chain activity quickly.

### get_tx_receipt_status
Check if a transaction succeeded or failed. Use this to confirm your actions went through correctly.

### proxy_call
Run an eth_call to interact with a contract. Test your logic without spending any actual gas.

### proxy_estimate_gas
Estimate the gas cost for a transaction. Use this to avoid overpaying or running out of gas.

### proxy_gas_price
Get the current gas price from the network. Check costs before you send a transaction.

### proxy_get_block_by_number
Fetch full block data by number. Get deep details on specific chain events and contents.

### proxy_get_code
Get the bytecode of a contract. This is useful for low-level verification and debugging.

### proxy_get_transaction_by_hash
Get full details of a specific transaction. Look up history quickly using a transaction hash.

### proxy_get_transaction_receipt
Get the receipt for a transaction hash. Verify the outcome of a specific call in detail.

### get_abi
Pull the ABI for a verified contract. Use this to decode transaction data easily in your tools.

### get_contract_execution_status
Check if a contract is currently executing correctly. This is great for debugging failed calls.

### get_eth_price
Get the current market price of Ether. Stay updated on value during your analysis.

### get_eth_supply
Fetch the total supply of Ether on the Boba Network. Use this for high-level chain overviews.

### get_ether_balance_multi
Pull Ether balances for a list of addresses at once. It saves time when auditing multiple wallets.

## Prompt Examples

**Prompt:** 
```
What's the current gas price on Boba L2?
```

**Response:** 
```
The current gas price on the Boba Network is **15.4 Gwei**. 

Here is a summary of the current network stats:
- **Gas Price**: 15.4 Gwei
- **ETH Price**: $2,450.12
- **Total ETH Supply**: 120,450,210 ETH
```

**Prompt:** 
```
Can you check the balance for 0x742d35Cc6634C0532925FC49964FedCc0AfB3359?
```

**Response:** 
```
I've checked the Boba L2 balance for that address:

- **Ether Balance**: 42.15 ETH
- **Status**: Active

Would you like me to list the recent transactions for this wallet as well?
```

**Prompt:** 
```
Get the source code for the contract at 0x1234... and tell me if it's verified.
```

**Response:** 
```
I've retrieved the verified source code for the contract at 0x1234... 

**Verification Status**: Verified

**Source Code Snippet (Solidity):**
```solidity
contract MyToken {
    uint256 public totalSupply;
    // ... rest of the verified code
}
```
```

## Capabilities

### Pull wallet balances
Get Ether and token balances for single or multiple addresses instantly.

### Audit contract source code
Retrieve verified source code and ABIs to see exactly how a dApp works.

### Track transaction history
List normal, internal, and ERC20/ERC721 transfers for any wallet.

### Monitor network stats
Check real-time gas prices, block rewards, and ETH price data on Boba.

### Execute JSON-RPC calls
Run low-level commands like getting block numbers or transaction receipts.

## Use Cases

### Auditing a new DeFi dApp
A developer wants to check a contract's logic. They ask their agent to pull the source code and ABI using get_source_code and get_abi to spot potential vulnerabilities.

### Monitoring whale movements
An analyst wants to see how a specific token is moving. They ask the agent to list all ERC20 transfers for a wallet using get_token_tx.

### Verifying a transaction failure
A user's transaction didn't go through. They ask the agent to check the receipt status using get_tx_receipt_status to see the specific error message.

### Bulk balance checking
A manager needs to see the Ether balance of 20 different wallets. They ask the agent to pull all of them at once using get_ether_balance_multi.

## Benefits

- Audit contracts faster by using get_source_code and get_abi to pull verified data directly into your workspace.
- Monitor portfolio health with get_ether_balance_multi and get_token_balance for instant multi-asset tracking.
- Debug failed interactions by checking get_tx_receipt_status and get_contract_execution_status in one go.
- Analyze tokenomics by pulling total supply data using get_token_supply and get_eth_supply on the Boba Network.
- Save on gas by using proxy_estimate_gas and proxy_gas_price to see costs before you commit to a transaction.
- Track complex movements with get_tx_list_internal and get_token_tx to see how tokens flow between contracts.

## How It Works

The bottom line is you get a direct pipeline to Boba Network data without manual searching.

1. Subscribe to the Bobascan MCP on Vinkius and add your Bobascan API Key.
2. Connect the Connector to your AI client like Claude or Cursor.
3. Ask your agent to fetch specific Boba L2 data like balances or transaction logs.

## Frequently Asked Questions

**How does the Bobascan MCP help with my Web3 development?**
It lets your AI agent pull verified source code and ABIs directly. This means you can debug contracts and understand dApp logic much faster without leaving your editor.

**Can I use Bobascan MCP to check my token balances?**
Yes, it can check both Ether balances and ERC20 token balances. You can even check multiple addresses at once to see your entire portfolio.

**Does Bobascan MCP work with Claude or Cursor?**
Yes, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf. You just connect it via Vinkius and start querying.

**Can I use this to see why a transaction failed?**
Absolutely. You can ask your agent to check the transaction receipt status. It will pull the specific details to help you identify the error.

**Is this Connector only for the Boba Network?**
Yes, this specific MCP is designed for the Boba L2 Network. It provides deep access to Bobascan's explorer data for that specific chain.

**Can I get real-time gas prices with Bobascan MCP?**
Yes, the Connector can fetch the current gas price and ETH price on the Boba Network, helping you time your transactions better.

**Can I check the Ether balance of multiple addresses at once?**
Yes! Use the `get_ether_balance_multi` tool and provide a comma-separated list of addresses to retrieve all balances in a single query.

**How do I view the source code of a verified smart contract?**
You can use the `get_source_code` tool with the contract's address. If the contract is verified on Bobascan, the AI will return the Solidity source code.

**Is it possible to track NFT transfers for a specific wallet?**
Yes, the `get_token_nft_tx` tool allows you to list ERC721 token transfer events associated with any address on the Boba network.