Aurorascan MCP. Query any L2 token balance, transaction history, or contract detail.

Aurorascan provides your AI agent deep access to the Aurora Network L2 blockchain. You'll get accurate data on balances, token movements, and transaction specifics without having to write a single line of code yourself.

Checking Balances and Supplies

You can check Ether balances for one address using get_balance, or you'll get the current Ether balance for a whole list of addresses at once with get_balance_multi. For token specifics, get_token_balance checks an ERC20 token’s balance against a specific contract and address. If you want to know the total amount of any ERC20 token circulating, use get_token_supply.

You can also pull the overall total circulating supply of Ether using get_eth_supply, and check the current market rate for Ether in both BTC and USD denominations with get_eth_price.

Tracking Token Transfers and Activity

To track token movements, you've got three distinct tools. Use get_token_tx to list all standard ERC20 transfers associated with an address or a block range. If you’re working with Non-Fungible Tokens (ERC721), get_token_nft_tx lists those specific transfer events for you. For multi-standard tokens, the get_token_1155_tx tool handles listing all ERC1155 transfers across an address or block range.

The general activity log can be pulled using get_logs, which fetches general log events tied to a contract or address interaction.

Reviewing Transaction History and Blocks

You'll get comprehensive transaction records through several functions. Start by pulling the list of normal, user-initiated transactions for an address using get_tx_list. If you need to know what happened inside those transactions—like internal contract calls and function executions—get_tx_list_internal handles that. You can check a transaction's final success or failure status by using get_tx_receipt_status against its unique hash.

For more detail, proxy_get_transaction_by_hash retrieves all metadata about any transaction given its hash identifier, and proxy_get_transaction_receipt gets the detailed receipt confirming exactly how that blockchain transaction executed.

When it comes to blocks, you can determine the current highest block number using proxy_block_number. You'll get a list of every block number mined by a specific wallet address with get_mined_blocks, and you can find out the reward (in native tokens) for mining a specified block with get_block_reward. To work with time, use get_block_no_by_time to find the block number corresponding to a given timestamp, or conversely, calculate how much time's left until the next block mines using get_block_countdown, which takes a block number as input.

Finally, proxy_get_block_by_number pulls all detailed data for any known block number.

Deep Contract and Network Analysis

For deep contract inspection, you've got the goods. You can confirm if a contract's source code has been officially verified on-chain using verify_source_code. If it hasn’t, you can still pull the full source code with get_source_code or grab the raw bytecode for an address using proxy_get_code. To understand how the contract works, use get_abi to retrieve the Application Binary Interface for a verified contract's source code.

You can also check if a specific smart contract interaction is still running or what its current execution status is by calling get_status. If you wanna test out what a function call would do without actually sending gas, proxy_call simulates that function execution, which is handy for testing inputs. To read data stored inside the contract's memory, use proxy_get_storage_at, which reads values from specific storage keys (slots).

You can also simulate network costs by calculating the estimated amount of gas needed with proxy_estimate_gas, or pulling the current recommended price for gas using proxy_gas_price.

The Workflow

You just ask your agent what you need—for example, "What was the total supply of USDC on Aurora last week?" Your AI client handles calling all these tools automatically. You'll get raw data points back that tell you everything you gotta know about the network.