# Aurorascan MCP > Aurorascan (Aurora Network L2 Block Explorer API) connects your AI agent directly to the Aurora L2 blockchain data. It lets you query current account balances, track every token transfer type (ERC20, NFTs, ERC1155), and pull comprehensive lists of normal or internal transactions using simple natural language prompts. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** aurora-network, block-explorer, ethereum-l2, web3-data, crypto-wallet ## Description Connecting your AI client to Aurorascan gives you deep visibility into the Aurora Network L2 blockchain. Instead of jumping between multiple block explorer tabs and manually stitching together data points, you ask your agent a question—like 'What happened with these three addresses last week?'—and it finds the answers for you. You can check balances for groups of wallets or trace token movements across different standards automatically. If you're building complex Web3 applications, having this deep data access integrated through Vinkius means you don't have to build custom retrieval pipelines; you just connect your agent and start querying. It lets you analyze contract interactions and even get the raw source code for verification, all without writing a single line of boilerplate API call. ## Tools ### get_abi Retrieves the Application Binary Interface (ABI) for verified smart contract source code. ### get_balance_multi Calculates and reports the Ether balance across a list of specified addresses simultaneously. ### get_balance Checks the current Ether balance for a single, specific blockchain address. ### get_block_countdown Determines and reports how many blocks are estimated to pass before a given block number is reached. ### get_block_no_by_time Finds the corresponding block number based on an exact timestamp provided. ### get_block_reward Calculates and reports the rewards associated with mining a specific block number. ### get_eth_price Fetches the latest market price data for Ether in both USD and BTC pairs. ### get_eth_supply Reports the total circulating supply of Ether currently available on the Aurora network. ### get_logs Retrieves detailed event logs generated by smart contracts for a given address or block range. ### get_mined_blocks Lists all the specific blocks that were mined by an address. ### get_source_code Fetches the original contract source code for verified smart contracts. ### get_status Checks and reports on the current execution status of a specific smart contract interaction. ### get_token_1155_tx Generates a list of all recorded transfer events for ERC1155 tokens. ### get_token_balance Reports the balance of a specific ERC20 token held by an address, identified by the contract address. ### get_token_nft_tx Generates a list detailing all transfer events for unique NFT tokens (ERC721). ### get_token_supply Determines and reports the total supply amount of a specific ERC20 token by its contract address. ### get_token_tx Lists all recorded transfer events for standard fungible tokens (ERC20). ### get_tx_list_internal Provides a list of complex, internal transactions that occur within the blockchain. ### get_tx_list Retrieves a comprehensive list of standard, non-internal transactions for an address. ### get_tx_receipt_status Checks the current status and outcome of a submitted transaction receipt. ### proxy_block_number Gets the latest available block number for the network. ### proxy_call Allows calling arbitrary functions on a contract without executing a transaction. ### proxy_estimate_gas Estimates how much gas will be required for a specific contract function call. ### proxy_gas_price Fetches the current recommended price for transaction gas. ### proxy_get_block_by_number Retrieves all data contained within a block, identified by its number. ### proxy_get_code Gets the raw compiled bytecode for a contract address. ### proxy_get_storage_at Reads specific data stored at a given slot within a smart contract's storage. ### proxy_get_transaction_by_hash Retrieves the full details of a transaction using its unique hash identifier. ### proxy_get_transaction_receipt Gets the final receipt, including gas used and status, for a completed transaction. ### verify_source_code Confirms that the source code provided matches the deployed contract bytecode. ## Prompt Examples **Prompt:** ``` What is the current balance of address 0x123...? ``` **Response:** ``` The current balance for address 0x123... is 4.52 ETH on the Aurora Network. ``` **Prompt:** ``` List the last 5 ERC20 token transfers for address 0xabc... ``` **Response:** ``` I found the 5 most recent ERC20 transfers for that address. Notable transfers include 100 USDC and 50 AURORA tokens. Would you like the transaction hashes for these? ``` **Prompt:** ``` Show me the normal transaction history for address 0xdef... sorted by descending order. ``` **Response:** ``` Fetching transaction history... I've retrieved the latest transactions for 0xdef... including a contract interaction at block 1045231 and a simple transfer at block 1045220. ``` ## Capabilities ### Check wallet balances You can check Ether balances for single or multiple addresses on the Aurora Network. ### Track token movements The MCP monitors and lists specific transfers for ERC20 tokens, NFTs (ERC721), and multi-standard assets (ERC1155). ### Review transaction history You can pull complete logs of both normal user transactions and complex internal contract calls. ### Analyze block data The tool provides metadata like the current estimated block countdown time or the total Ether supply on Aurora. ### Inspect smart contracts It allows you to retrieve contract source code, verify status, and check specific parameters for deep auditing. ## Use Cases ### Auditing a suspicious wallet. A security analyst needs to know if a compromised account was involved in any unusual token movements. They ask their agent to run `get_token_tx` combined with `get_logs` for the last 48 hours, instantly filtering out normal activity and providing only the actionable events. ### Verifying a contract's function. A developer needs to ensure a new smart contract handles gas limits correctly before deployment. They use `proxy_estimate_gas` first, then run `get_source_code` to check the logic against the estimate, ensuring the code behaves as expected. ### Tracking asset consolidation. A portfolio manager wants a total value report for 15 different wallets. They use `get_balance_multi` and then request all associated ERC20 balances using `get_token_balance`, getting a single, consolidated view of the entire holdings. ### Investigating block activity. A researcher wants to understand network participation patterns. They ask the agent to run `get_mined_blocks` for specific validator addresses and cross-reference that list with transaction data using `get_tx_list`. ## Benefits - Automate portfolio checks. Instead of running multiple manual queries to check balances, use a single prompt with `get_balance` or `get_balance_multi` to see the total wealth across several addresses at once. - Deep-dive into asset types. Track everything from standard ERC20 transfers using `get_token_tx` to unique NFT movements via `get_token_nft_tx`, giving you a full view of asset liquidity. - Debug contract failures instantly. If a transaction fails, use `proxy_get_transaction_receipt` or `get_status` to immediately understand why the execution stopped, saving hours of manual debugging. - Contextual data retrieval. Need to know what code was used? You can call `get_source_code` and then cross-reference it with a transaction using `proxy_get_transaction_by_hash`—all in one chat session. - Time savings on auditing. Instead of manually checking block explorers for internal calls, use `get_tx_list_internal` to pull every piece of complex activity related to an address. ## How It Works The bottom line is you get automated access to complex blockchain data without writing custom API code. 1. Subscribe to the Aurorascan MCP and input your unique API key into Vinkius. 2. Connect your preferred AI client (Claude, Cursor, etc.) to the Vinkius catalog. 3. Ask a natural language query—for instance, 'List all ERC20 transfers for this wallet.'—and let your agent run the necessary tools. ## Frequently Asked Questions **How do I check multiple wallet balances using Aurorascan MCP?** You use the `get_balance_multi` tool. You provide a list of addresses, and the MCP returns all their current Ether balances in one comprehensive response. **Can Aurorascan MCP track ERC721 NFTs?** Yes, you use the `get_token_nft_tx` tool. This specifically tracks transfer events for unique NFT tokens (ERC721), allowing you to build a complete record of ownership history. **What is the difference between getting normal and internal transactions?** Normal transactions are simple user actions, retrieved with `get_tx_list`. Internal transactions (`get_tx_list_internal`) track complex interactions that happen *within* smart contracts, which are crucial for deep auditing. **How do I check if a transaction succeeded?** You use `get_tx_receipt_status` or the `proxy_get_transaction_receipt` tool. This tells you if the transaction completed successfully, failed due to gas limits, or if it's still pending. **Does Aurorascan MCP provide total token supply?** Yes, you can use `get_token_supply` to find out the total circulating amount for any specific ERC20 token by providing its contract address.