# Gnosisscan MCP for AI Agents AI Agent Connect > Gnosisscan MCP gives your AI agent direct access to Gnosis Chain data. Query xDAI balances, track ERC20 and NFT transfers, and pull verified smart contract source code or ABIs without leaving your workspace. It turns the Gnosis Chain explorer into a searchable database for your agent. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_44M3DTxD2Ha8YDXAA6hjLJysaCrbfbXxfPLB1xVK/ai-agent-connect - **Tags:** gnosis-chain, block-explorer, xdai, smart-contracts, web3 ## Description Stop jumping back and forth between your IDE and a browser tab just to check a balance or grab a contract ABI. The Gnosisscan MCP brings the entire Gnosis Chain data environment directly into your chat interface. You can ask your agent to pull xDAI balances, track specific token movements, or dig into internal transaction flows without ever leaving your workspace. It's a huge win for anyone who needs to move fast. You'll find it in the Vinkius catalog alongside other high-performance tools designed to cut out the friction of manual data entry. Instead of copy-pasting hex codes or hunting for verified source code, you just tell your agent what you need. It handles the heavy lifting of querying the blockchain and feeds you the raw data or a summarized breakdown instantly. Whether you're auditing a smart contract or monitoring a DeFi protocol's liquidity, this Connector makes the blockchain feel like a local database. ## Tools ### proxy_getcode Get the bytecode for a contract using an eth_getCode proxy. This is useful for low-level analysis. ### get_account_balance_multi Get the xDAI balance for multiple addresses at once. Use this to audit a large group of wallets. ### get_account_balance Get the xDAI balance for a single address. Use this to quickly check a specific wallet's holdings. ### get_account_minedblocks Get a list of blocks validated by a specific address. This is useful for checking validator activity. ### get_account_tokennfttx Get a list of ERC721 token transfer events for an address. Use this to track NFT movements. ### get_account_tokentx Get a list of ERC20 token transfer events for an address. This tracks standard token movements. ### get_account_txlist_internal Get a list of internal transactions for an address. This reveals deeper contract interactions. ### get_account_txlist Get a list of normal transactions for an address. Use this to view standard wallet history. ### get_block_bytime Get the block number for a specific timestamp. This helps you find data from a certain point in time. ### get_block_countdown Get the estimated block countdown time for a specific block number. Use this to track mining progress. ### get_block_reward Get the reward for a specific block number. This is useful for analyzing validator earnings. ### get_contract_abi Get the ABI for a verified smart contract. Use this to understand the functions available on a contract. ### get_contract_sourcecode Get the verified source code for a smart contract. This is essential for deep technical audits. ### get_logs Get event logs from the blockchain. Use this to filter specific contract events. ### get_stats_ethsupply Get the total supply of xDAI on the Gnosis Chain. Use this for high-level supply metrics. ### get_stats_gnoprice Get the latest price for GNO and xDAI. This provides current market price data. ### get_tx_receiptstatus Check the receipt status of a transaction. Use this to see if a specific move succeeded. ### get_tx_status Check the execution status of a contract. Use this to see if a complex interaction finished. ### proxy_blocknumber Get the current block number using an eth_blockNumber proxy. This provides the latest chain height. ### proxy_call Perform an eth_call proxy. Use this to read data from a contract without sending a transaction. ### proxy_estimategas Estimate the gas required for a transaction using an eth_estimateGas proxy. This helps plan costs. ### proxy_gasprice Get the current gas price using an eth_gasPrice proxy. Use this to check network congestion. ### proxy_getblockbynumber Get block details by number using an eth_getBlockByNumber proxy. This retrieves full block data. ### proxy_getstorageat Get the storage value at a specific slot using an eth_getStorageAt proxy. Use this for deep state inspection. ### proxy_gettransactionbyhash Get transaction details by hash using an eth_getTransactionByHash proxy. Use this to see full tx details. ### proxy_gettransactionreceipt Get the transaction receipt by hash using an eth_getTransactionReceipt proxy. This confirms finality. ## Prompt Examples **Prompt:** ``` What is the xDAI balance of address 0x0000000000000000000000000000000000000000? ``` **Response:** ``` I've checked the balance for that address. It currently holds **0.00 xDAI** on the Gnosis Chain. ``` **Prompt:** ``` List the last 5 normal transactions for address 0x123...456. ``` **Response:** ``` Fetching transaction history... I found the most recent transactions for that address, including a transfer of **10 xDAI** and several contract interactions. | Transaction Type | Amount | Status | | :--- | :--- | :--- | | Transfer | 10 xDAI | Success | | Contract Call | 0 xDAI | Success | ``` **Prompt:** ``` Get the ABI for the contract at 0x789...012. ``` **Response:** ``` I have retrieved the ABI for the requested contract. It includes the following core functions: * `transfer(address,uint256)` * `balanceOf(address)` * `approve(address,uint256)` I can now help you format calls to this contract if you'd like. ``` ## Capabilities ### Check xDAI Balances Get the current xDAI balance for a single wallet or a list of multiple addresses. ### Track Token Transfers Monitor ERC20 token movements and ERC721 NFT transfers for any specific account. ### Audit Smart Contracts Pull verified source code and ABIs for technical analysis of any contract on the chain. ### Monitor Network Stats Get real-time data on gas prices, block rewards, and GNO price metrics. ### Verify Transaction Status Check the receipt status and execution status of specific contract transactions. ## Use Cases ### Smart Contract Auditing A developer needs to check a contract's logic. They ask their agent to pull the source code and ABI using get_contract_sourcecode and get_contract_abi to review the functions. ### Whale Tracking A data analyst wants to see where a large amount of xDAI went. They ask the agent to list the last 10 internal transactions for a specific address using get_account_txlist_internal. ### NFT Portfolio Review A user wants to see their NFT history. They ask the agent to list all ERC721 transfers for their wallet using get_account_tokennfttx. ### Real-time Gas Monitoring A DeFi user wants to know if it's a good time to swap. They ask the agent to check the current gas price and GNO price using proxy_gasprice and get_stats_gnoprice. ## Benefits - Stop manual tab switching by using get_account_balance to check wallet holdings directly in your chat. - Perform deep audits faster with get_contract_sourcecode and get_contract_abi to see verified code instantly. - Track complex movements across the chain with get_account_tokentx and get_account_tokennfttx for ERC20 and NFTs. - Get accurate network data with get_stats_gnoprice and proxy_gasprice to monitor market conditions. - Verify transaction success instantly with get_tx_receiptstatus and get_tx_status without hunting for hashes. - Audit multiple wallets at once using get_account_balance_multi to save time on bulk data collection. ## How It Works The bottom line is you get direct blockchain data in your chat without opening a single extra tab. 1. Subscribe to the Gnosisscan MCP and add your Gnosisscan API key to your configuration. 2. Connect the Connector to your preferred AI client like Claude or Cursor. 3. Ask your agent to find balances, list transactions, or fetch contract code using natural language. ## Frequently Asked Questions **Can I use Gnosisscan MCP to check xDAI balances?** Yes, you can ask your agent to check the xDAI balance for any single address or a list of multiple addresses at once. **Does Gnosisscan MCP support NFT tracking?** It does. You can use it to pull ERC721 token transfer events for any specific address on the Gnosis Chain. **Can I get the source code of a smart contract with Gnosisscan MCP?** Yes, if the contract is verified on the explorer, you can ask your agent to pull the source code or the ABI for technical analysis. **Does Gnosisscan MCP show real-time gas prices?** Yes, it provides real-time metrics including current gas prices and GNO price data to help you time your transactions. **Is Gnosisscan MCP for the Ethereum mainnet?** No, this Connector is specifically for the Gnosis Chain. You'll need a different tool if you're looking for Ethereum mainnet data. **How do I see internal transactions using Gnosisscan MCP?** Your agent can pull a list of internal transactions for any address, which is helpful for seeing complex contract-to-contract interactions. **Can I check the balance of multiple Gnosis Chain addresses at once?** Yes! Use the `get_account_balance_multi` tool and provide a comma-separated list of addresses to get all balances in a single request. **How do I see the ERC20 token transfer history for an account?** You can use the `get_account_tokentx` tool. Simply provide the account address, and optionally a specific contract address, to list all relevant token movements. **Is it possible to retrieve the source code of a verified smart contract?** Yes, the `get_contract_source_code` tool allows you to fetch the source code for any verified contract on Gnosisscan using its address.