Metisscan MCP for AI. Audit block states and trace on-chain asset flow.

You connect your agent directly to the Metis L2 blockchain state. This server lets you programmatically inspect everything from block headers to deep contract calls, letting you audit data without ever leaving your development environment.

Reading Network State

You can check the current network status by retrieving the latest block number using eth_block_number or listing recent finalized blocks with list_blocks. To dig into specific history, call get_block for general metrics (like timestamps and difficulty) or use eth_get_block_by_number to pull all detailed information associated with a single block. You can also list every individual transaction that was included in a given block using get_block_transactions, and get the full details of an entire block via get_block.

Auditing Addresses and Balances

Need to know what an address holds? Use eth_get_balance to check its native token balance. For a deeper dive, get_address_tokens lists every type of token the address currently owns, while get_address_transactions pulls a full history of all transactions linked to that specific wallet or contract. You can also get basic identification details using get_address, and track an account's activity count with get_address_counters.

To see who holds a particular asset across the network, run get_token_holders.

Analyzing Transaction Flow

When you pull a single transaction hash, get_transaction gives you all the inputs and gas usage details. You can get even more specific data by using eth_get_transaction_by_hash, which pulls comprehensive records for that one event. To understand if a transaction succeeded or failed, use eth_get_transaction_receipt; this returns the execution receipt and success status.

If you need to track exactly what changed during an execution—like when 'User X bought Token Y'—get_transaction_logs retrieves all emitted event logs. For complex fund movements, get_transaction_internal_transactions lists secondary contract calls that were triggered by the main transaction.

To plan out your moves, you can get a gas cost estimate using eth_estimate_gas, and run a dry-run function call without spending any gas or changing state with eth_call. You can also pull all historical transactions linked to an address using get_address_transactions.

Inspecting Smart Contract Logic

Got a contract you want to check? Use get_smart_contract to get general metadata. To see the actual code, eth_get_code provides the bytecode or source code deployed at an address. If you need proof that the code is accurate, get_smart_contract_verification_config retrieves the verification setup. You can also check details for a specific token type using get_token, and view all available standards with list_tokens.

For tracking asset movement over time, get_token_transfers lists historical transfers for any given token.

Advanced Querying & Utilities

You'll need the graphql_query tool when standard lookups aren't enough; it lets you run custom queries against the Metisscan index to retrieve highly specific data across the whole network. You can also get general details on a contract using get_smart_contract and pull a list of recent transaction hashes with list_transactions, or see all available tokens via list_tokens.

The server lets you fetch detailed information for an entire block using get_block, ensuring you have full context when auditing the ledger.