# Aurorascan MCP for AI Agents AI Agent Connect > Aurorascan lets you pull real-time data from the Aurora Network L2 blockchain directly into your AI agent. You can check wallet balances, look up transaction histories, and track token transfers without manually navigating a block explorer. It turns complex on-chain data into plain text answers for faster auditing, developer debugging, and portfolio tracking. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_aZJVpFpX7I4vpPG8pvf6QvqGY5xA5tSIEDL5NH5N/ai-agent-connect - **Tags:** aurora-network, block-explorer, ethereum-l2, web3-data, crypto-wallet ## Description Imagine you're deep in a debugging session and need to see if a specific contract interaction actually landed on the Aurora Network. Instead of opening a new tab, hunting for a hash, and squinting at a block explorer, you just ask your AI agent to check it for you. This Connector bridges that gap. It connects your agent to the Aurorascan API, giving it the eyes it needs to see what's happening on-chain. You can ask about specific wallet balances, pull a list of internal transactions, or check the status of a contract execution while you stay focused on your current task. Whether you're a developer verifying a deployment or an analyst pulling data for a report, this tool removes the friction of context switching. It's one of the many high-quality integrations you can find in the Vinkius catalog, making it easy to plug into your existing workflow. You get direct access to token supplies, gas prices, and even source code for verified contracts, all through a conversational interface that understands your intent. You can monitor various asset movements, verify contract logic, and get real-time price updates. This means you spend less time copy-pasting data and more time making decisions. It turns the Aurora Network into a searchable database for your AI. ## Tools ### get_abi This retrieves the Application Binary Interface for a verified contract. It helps your agent understand how to interact with the contract correctly. ### get_balance_multi This tool fetches the Ether balance for a list of multiple addresses at once. It is great for checking the total balance of several wallets in one go. ### get_balance This checks the current Ether balance for a single specific address. You can use it to quickly see how much funds a specific wallet holds. ### get_block_countdown This shows the estimated time remaining until the next block is mined. It helps you plan when your next transaction might be processed. ### get_block_no_by_time This finds the specific block number associated with a given timestamp. It is useful for looking up historical data from a specific point in time. ### get_block_reward This shows the reward amount for a specific block number. Use it to analyze the rewards being distributed on the network. ### get_eth_price This provides the current price of Ether in both USD and BTC. It keeps you updated on market conditions without leaving your chat. ### get_eth_supply This returns the total circulating supply of Ether on the Aurora Network. It is a core metric for any blockchain data analysis. ### get_logs This retrieves event logs for a specific block or transaction. It lets you see the specific events triggered by smart contract interactions. ### get_mined_blocks This lists all the blocks that have been mined by a specific address. It helps you identify the activity of specific validators or miners. ### get_source_code This pulls the verified source code for a contract from the explorer. You can use it to audit the logic of a decentralized application. ### get_status This checks whether a contract execution succeeded or failed. It is a quick way to verify the outcome of a specific on-chain action. ### get_token_1155_tx This lists all transfer events for ERC1155 tokens. It helps you track the movement of multi-token standards on the Aurora Network. ### get_token_balance This checks the balance of an ERC20 token for a specific address. Use it to see how many of a specific asset a user holds. ### get_token_nft_tx This lists all transfer events for ERC721 (NFT) tokens. It is perfect for tracking the sale or movement of digital collectibles. ### get_token_supply This shows the total supply of an ERC20 token. It gives you a high-level view of a specific token's circulation. ### get_token_tx This lists all transfer events for ERC20 tokens. Use it to see the recent history of a specific token's movements. ### get_tx_list This pulls a list of all standard transactions for an address. You can use it to see the general activity of a specific wallet. ### get_tx_receipt_status This checks if a transaction has been confirmed and its status. It is your primary tool for verifying that a transfer went through. ### proxy_block_number This gets the current block number on the network. It helps you keep track of the current state of the blockchain. ### proxy_call This executes a read-only call to a smart contract. Use it to query specific data points from a contract without spending gas. ### proxy_estimate_gas This estimates the gas required for a specific contract call. It helps you avoid running out of gas during complex interactions. ### proxy_gas_price This retrieves the current gas price for the network. Use it to check the cost of transactions in real time. ### proxy_get_block_by_number This fetches all data for a specific block by its number. It is useful for deep inspection of any historical block. ### get_tx_list_internal This pulls a list of all internal transactions for an address. It is essential for tracing complex movements between contracts. ### proxy_get_code This tool pulls the bytecode for a specific smart contract. It helps you understand the underlying logic of a contract on the Aurora Network. ### proxy_get_storage_at This lets you see the storage value at a specific slot in a contract. It is useful for checking the state of a contract without a custom script. ### proxy_get_transaction_by_hash This pulls the full details of a transaction using its unique hash. You can use it to see exactly what happened during a specific blockchain event. ### proxy_get_transaction_receipt This gets the final status and receipt of a completed transaction. It tells you if your interaction succeeded or failed on the Aurora Network. ### verify_source_code This tool checks if a contract's source code has been verified on the explorer. It is a key step for ensuring you are interacting with a legitimate contract. ## Prompt Examples **Prompt:** ``` What's the balance of 0x123...? ``` **Response:** ``` The wallet **0x123...** currently holds **15.42 ETH** on the Aurora Network. ``` **Prompt:** ``` Show me recent USDC transfers for this wallet. ``` **Response:** ``` I found 3 recent USDC transfers for that address: | Date | Amount | | :--- | :--- | | 10:00 AM | 500.00 | | 09:45 AM | 120.00 | | 08:30 AM | 1000.00 | ``` **Prompt:** ``` Did the contract at 0xABC... deploy successfully? ``` **Response:** ``` Yes, the contract at **0xABC...** was successfully deployed. The transaction receipt shows a **Success** status at block 1234567. ``` ## Capabilities ### Check wallet balances Fetch the current Ether balance for a single address or a list of multiple addresses at once. ### Pull transaction histories Retrieve lists of normal, internal, and failed transactions for any specific wallet. ### Track token movements Monitor transfer events for various token standards including ERC20, ERC721, and ERC1155. ### Verify contract source code Access the verified source code and ABI for contracts already listed on the explorer. ### Monitor network metrics Get real-time data on gas prices, total supply, and block rewards across the network. ### Inspect block data Query specific block parameters, mined blocks, and transaction logs for deep auditing. ## Use Cases ### Debugging a failed deployment A developer asks their agent to check the get_tx_receipt_status for a specific hash to see why a contract failed to deploy on the Aurora Network. ### Portfolio distribution audit A data analyst asks the agent to pull the get_token_balance for 20 different wallets to verify a token distribution for a report. ### Tracking NFT sales A collector asks their agent to list all get_token_nft_tx for a specific address to see a history of recent digital collectible sales. ### Pre-transaction gas check A bot developer asks the agent to pull the proxy_gas_price and proxy_estimate_gas before pushing a high-priority transaction. ## Benefits - Quickly verify transaction success with get_tx_receipt_status to ensure your smart contract interactions landed correctly. - Audit complex contract behaviors by pulling internal transactions with get_tx_list_internal for a full view of on-chain activity. - Track NFT sales and movements easily by pulling ERC721 transfer events with get_token_nft_tx directly into your chat. - Check multiple wallet balances simultaneously using get_balance_multi to monitor an entire portfolio in one command. - Verify contract safety by pulling verified source code with get_source_code to audit the logic of any decentralized application. - Stay updated on market conditions by pulling real-time Ether prices with get_eth_price without leaving your workspace. ## How It Works The bottom line is you get instant on-chain data without ever leaving your chat interface. 1. Subscribe to the Aurorascan MCP via the Vinkius Marketplace. 2. Enter your Aurorascan API Key into the configuration settings. 3. Ask your AI client to query specific Aurora Network L2 data using natural language. ## Frequently Asked Questions **What can the Aurorascan MCP do for my blockchain projects?** It lets your AI agent pull real-time data from the Aurora Network L2. You can check balances, transaction statuses, and token movements without leaving your chat app. **Can I use Aurorascan MCP to track my NFT collection?** Yes, you can use it to pull ERC721 transfer events. This makes it easy to see who owns what and track recent movements on the Aurora Network. **How does Aurorascan MCP help with smart contract debugging?** It allows your agent to check transaction receipts and contract execution statuses. You can quickly verify if a specific interaction worked as intended. **Can I check multiple wallet balances at once with Aurorascan MCP?** Yes, you can pull the Ether balances for a list of addresses in a single request. This is great for auditing distributions or checking portfolio totals. **Does Aurorascan MCP work for the Ethereum mainnet?** No, this Connector is specifically built for the Aurora Network L2. If you need data from other chains, you will need a different connector. **Can I get gas prices using Aurorascan MCP?** Yes, the Connector can provide the current gas price and estimate the gas needed for specific calls. This helps you plan your transactions more accurately. **Is it possible to see the source code of a contract via Aurorascan MCP?** Yes, if a contract is verified, you can ask your agent to pull the source code and ABI directly from the explorer. **Can I check the balance of multiple wallet 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 all specified accounts in a single response. **How do I track NFT transfers for a specific user?** You can use the `get_token_nft_tx` tool by providing the user's wallet address. This will list all ERC721 token transfer events associated with that address. **Does this server support internal transactions?** Absolutely. The `get_tx_list_internal` tool allows you to query internal transactions by either a wallet address or a specific transaction hash.