# Metisscan MCP for AI Agents AI Agent Connect > Metisscan MCP for AI Agents connects your agent to the Metis Layer 2 network. It lets you pull real-time data on blocks, transactions, wallet balances, and smart contract source code. Instead of manually digging through a web explorer, your agent handles the heavy lifting of fetching on-chain data across the Metis ecosystem. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_zyQr84ZqWsm75UyKe8SMUHe3tqoUUbpiQAh6jf7t/ai-agent-connect - **Tags:** metis, layer2, blockchain-explorer, ethereum-scaling, smart-contracts ## Description The Metisscan MCP for AI Agents connects your agent to the Metis Layer 2 ecosystem. When you're digging into blockchain data, you usually end up with dozens of tabs open, constantly refreshing a block explorer to see if a transaction landed or if a contract is behaving. This Connector changes that by letting your AI agent do the heavy lifting for you. Instead of you manually searching for an address or copying over transaction logs, you just ask your agent to find the data. It can pull specific block details, check the balance of any wallet, or even grab the source code for a verified smart contract. If you're trying to debug a tricky interaction, the agent can look at internal calls and event logs to show you exactly what's happening under the hood. It's a huge time-saver for anyone who needs to keep a pulse on the Metis ecosystem without the manual overhead. You can find this and thousands of other tools in the Vinkius catalog to give your agent the specific access it needs to be useful. It's about moving from searching for data to getting answers in one conversation. ## Tools ### eth_call Execute a message call on the network. This allows you to interact with smart contracts directly. ### eth_estimate_gas Get a gas estimate for a transaction. Use this to calculate costs before you send a call. ### eth_get_block_by_number Get full details for a specific block. Use this to see what happened at a specific point in time. ### eth_get_code Pull the code at a specific address. This is useful for identifying the contract at a location. ### eth_get_transaction_by_hash Find a specific transaction using its hash. It gives you the full history of that single action. ### eth_get_transaction_receipt Get the final receipt for a transaction. Use this to confirm if a move succeeded or failed. ### get_address_counters Get transaction and token counts for a wallet. This gives you a quick overview of an address's activity level. ### get_address_tokens List all token balances for a specific address. It's great for seeing a user's full portfolio. ### get_address Pull general details for any address. Use this to get a high-level summary of a wallet or contract. ### get_address_transactions List all transactions for a specific address. It helps you see a wallet's history at a glance. ### get_block Get the full details of a specific block. Use this to see every transaction included in a block. ### get_block_transactions List every transaction within a specific block. This is perfect for auditing a single block's contents. ### get_smart_contract Get the details of a specific smart contract. Use this to learn about a contract's purpose and status. ### get_smart_contract_verification_config Get the verification settings for a contract. This helps you see how a contract was deployed. ### get_token_holders List the holders of a specific token. This is the go-to tool for checking token distribution. ### graphql_query Run a GraphQL query against Metisscan. Use this for complex data fetching that standard tools can't handle. ### eth_block_number Get the most recent block number. Use this to check the current height of the blockchain. ### eth_get_balance Check the balance of any address. It's the quickest way to see a wallet's current funds. ### get_token Get the details for a specific token. Use this to check a token's name, symbol, and other info. ### get_token_transfers List all transfers for a specific token. This helps you track the movement of assets across the network. ### get_transaction_internal_transactions List internal calls triggered by a transaction. This is vital for debugging complex contract interactions. ### get_transaction_logs List all event logs for a specific transaction. Use this to see the specific events emitted by a contract. ### get_transaction Get the full details of a specific transaction. This provides the complete history of a single move. ### list_blocks Get a list of the most recent blocks. This is the best way to see current network activity. ### list_tokens List all tokens currently on the network. Use this to explore the available assets on Metis L2. ### list_transactions List the most recent transactions on the network. This gives you a live feed of what's happening now. ## Prompt Examples **Prompt:** ``` Show me the last 5 transactions for this wallet: 0x123...abc. ``` **Response:** ``` I've pulled the recent transaction history for that address. Here is the summary: | Hash | Value | Status | | :--- | :--- | :--- | | 0x7a...f2 | 1.2 METIS | Success | | 0x3b...e1 | 50.0 METIS | Success | | 0x9c...a4 | 0.5 METIS | Success | | 0x1d...b9 | 2.1 METIS | Success | | 0x5e...c8 | 10.0 METIS | Success | Would you like me to pull the full details for any of these? ``` **Prompt:** ``` Is the contract at 0x456...def verified? If so, what's the source code? ``` **Response:** ``` I've checked the verification status for that contract. **Status**: Verified **Source Language**: Solidity **Verification Config**: Included I have retrieved the source code for you. It is a standard 'TransparentUpgradeableProxy' implementation. Would you like me to analyze any specific functions in the code? ``` **Prompt:** ``` Who are the top 5 holders of the METIS token? ``` **Response:** ``` I've retrieved the current token holder list for METIS. Here are the top 5: * **Address 0x1a...2b**: 1,200,000 METIS * **Address 0x3c...4d**: 950,000 METIS * **Address 0x5e...6f**: 800,000 METIS * **Address 0x7g...8h**: 750,000 METIS * **Address 0x9i...0j**: 700,000 METIS Would you like to see the transaction history for any of these addresses? ``` ## Capabilities ### Pull wallet balances Get the current holdings and balance for any Metis address instantly. ### Track transaction history See a full list of past movements for a specific wallet or contract. ### Inspect smart contracts View source code and verification details for contracts on the network. ### Monitor block data Fetch recent blocks, transaction counts, and specific block details. ### Analyze token movements List token holders and track transfers across the Metis L2 ecosystem. ### Execute contract calls Run messages and estimate gas for interactions on the blockchain. ## Use Cases ### Debugging a failed swap A dev asks why a transaction failed. The agent uses get_transaction_logs and get_transaction_internal_transactions to find the specific event that triggered the error. ### Tokenomics research An analyst wants to see the top holders of a new project. They ask the agent to list holders and then check the balance of the top 10. ### Real-time monitoring A power user wants to know if a whale just moved funds. They ask the agent to list transactions for a specific address and summarize the last 5. ### Contract verification A developer needs to see if a contract is verified. The agent pulls the verification config and source code for a specific address. ## Benefits - Stop manual tab switching by pulling Metis L2 data directly into your AI client. - Debug complex contract interactions faster using get_transaction_internal_transactions to see internal calls. - Audit token distribution instantly with get_token_holders to see who owns what. - Verify smart contract integrity by pulling source code and verification configs with get_smart_contract_verification_config. - Monitor real-time network activity by listing recent blocks and transactions without a browser. - Analyze wallet portfolios quickly by using get_address_tokens to see every asset held. ## How It Works The bottom line is you get a direct line to Metis L2 data without leaving your chat interface. 1. Connect your Metisscan API key to the Connector. 2. Link the Connector to your AI client like Claude or Cursor. 3. Ask your agent to query the Metis L2 network in plain English. ## Frequently Asked Questions **What can I do with the Metisscan MCP?** You can use your AI agent to query the Metis Layer 2 network. This includes checking wallet balances, listing recent transactions, inspecting smart contract source code, and monitoring token movements. **Does the Metisscan MCP work for Ethereum Mainnet?** No, this Connector is specifically designed for the Metis Layer 2 network. It provides deep access to Metis-specific data and explorers. **How do I use Metisscan MCP to debug a transaction?** Your agent can pull transaction logs and internal calls for a specific hash. This helps you see exactly where a transaction failed or what internal contract steps were taken. **Can I check my token balances with Metisscan MCP?** Yes, you can ask your agent to list all token balances for any specific wallet address on the Metis network. **Is Metisscan MCP good for tracking whale movements?** It's excellent for that. You can ask your agent to monitor a specific whale's address and list all their recent transactions in real time. **Can I see the source code of a contract using Metisscan MCP?** Yes, if the contract is verified on Metisscan, your agent can pull the verification configuration and the source code for you to review. **How do I get started with the Metisscan MCP?** You'll need a Metisscan API key. Once you have that, you can connect it through Vinkius to your preferred AI client like Claude or Cursor. **Can I check the balance and token holdings of a specific wallet address?** Yes. Use the `getAddress` tool for the main balance and `getAddressTokens` to list all ERC-20 tokens held by that specific address on the Metis network. **How do I inspect the internal calls or logs of a specific transaction?** You can use `getTransactionInternalTransactions` to see contract-to-contract interactions and `getTransactionLogs` to retrieve event data emitted during execution. **Is it possible to query the network using GraphQL or standard EVM RPC methods?** Absolutely. This server includes `executeGraphql` for complex queries and a full suite of EVM tools like `ethBlockNumber`, `ethGetBalance`, and `ethCall`.