# Gnosisscan MCP > Gnosisscan (Gnosis Chain Explorer) gives your AI agent direct access to Gnosis Chain data. You can query xDAI balances, track ERC20 and NFT transfers, list transaction history, and retrieve smart contract source code—all without opening a browser tab. It's like having the entire blockchain explorer built into your chat interface. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** gnosis-chain, block-explorer, xdai, smart-contracts, web3 ## Description Need to audit an account or trace complex asset movements on Gnosis Chain? This MCP connects your agent directly to the chain data via Gnosisscan, letting you analyze everything conversationally. Instead of jumping between tabs and manually checking multiple addresses, you ask your AI client a question—like 'What were all the transfers for this NFT?'—and it gets the raw data back instantly. You can check current xDAI balances across dozens of wallets or pull historical transaction lists, including deep internal contract calls. The whole process is managed through Vinkius, giving you access to thousands of specialized tools and keeping your workflow right where you are. It's pure blockchain intelligence in plain language. ## Tools ### get_account_balance_multi Checks the xDAI balances for a list of multiple addresses at once. ### get_account_balance Gets the xDAI balance held by one specific address. ### get_account_minedblocks Lists all block numbers that were validated by a given address. ### get_account_tokennfttx Retrieves records of ERC721 NFT transfers associated with an address. ### get_account_tokentx Gets a list of all ERC20 token transfer events for any specific address. ### get_account_txlist_internal Lists all internal, contract-to-contract transactions for an address. ### get_account_txlist Provides a history of normal transactions that occurred at an address. ### get_block_bytime Finds the corresponding block number given a specific timestamp. ### get_block_countdown Estimates how long it will take until the next block is validated. ### get_block_reward Determines the reward received for validating a specific block number. ### get_contract_abi Fetches the Application Binary Interface (ABI) for verified contract code. ### get_contract_sourcecode Retrieves the human-readable source code for a contract. ### get_logs Gets event logs emitted during a transaction period. ### get_stats_ethsupply Calculates and returns the total circulating supply of xDAI on Gnosis Chain. ### get_stats_gnoprice Gathers the latest market price data for both GNO and xDAI. ### get_tx_receiptstatus Checks if a specific transaction receipt has been fully processed by the network. ### get_tx_status Verifies the execution status of a contract interaction or transaction. ### proxy_blocknumber Gets the current block number using an Ethereum proxy call. ### proxy_call Executes arbitrary calls against a contract address via proxy methods. ### proxy_estimategas Estimates the gas required for a transaction before sending it. ### proxy_gasprice Retrieves the current recommended gas price for transactions. ### proxy_getblockbynumber Fetches an entire block's details using its number proxy. ### proxy_getcode Checks the bytecode associated with a contract address. ### proxy_getstorageat Reads specific storage key data from a contract's state. ### proxy_gettransactionbyhash Fetches transaction details using its unique hash identifier. ### proxy_gettransactionreceipt Gets the full receipt of a transaction by providing its hash. ## 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. Would you like details on a specific hash? ``` **Prompt:** ``` Get the ABI for the contract at 0x789...012. ``` **Response:** ``` I have retrieved the ABI for the requested contract. It includes functions like `transfer`, `balanceOf`, and `approve`. I can now help you format calls to this contract. ``` ## Capabilities ### Check Account Balances Retrieve the current xDAI balance for a single or multiple addresses. ### Analyze Token Transfers Get detailed lists of both ERC20 token movements and specific ERC721 NFT transfer events by address. ### Audit Transaction History List all normal transactions or internal contract interactions that occurred at a given address. ### Examine Smart Contract Code Fetch verified ABI and source code for deep technical analysis of specific contracts. ### View Network Metrics Get real-time data on gas prices, block rewards, or the total supply of xDAI. ## Use Cases ### Tracking a high-value NFT transfer A user needs to know if a specific rare NFT left a wallet. Instead of searching through block logs manually, the agent runs `get_account_tokennfttx` on the source address and filters for the contract ID, immediately showing the recipient's details. ### Verifying DeFi collateral status A developer needs to audit a loan protocol. They use `proxy_getstorageat` against the smart contract to pull the specific storage slot holding the collateral value, bypassing public-facing balance checkers and getting raw state data. ### Debugging an internal transaction A user sees a strange activity in their history. They use `get_account_txlist_internal` to see which specific contract initiated the transfer, then they can use `proxy_gettransactionbyhash` on that hash to trace exactly where the funds went. ### Checking network readiness before deployment A dev wants to estimate costs. They run `proxy_estimategas` first, then check `get_block_countdown` to see if gas prices are stable enough for their planned transaction window. ## Benefits - Eliminate tab hopping. Instead of opening the Gnosisscan site, copying an address, navigating to a new tab, and running multiple queries, you just ask your agent, and it runs everything in one chat window. - Deep technical visibility. You can retrieve contract source code or use `get_contract_abi` on demand. This is critical for validating if a smart contract behaves the way its developers intended. - Comprehensive tracking. Need to know what happened with an NFT? Use `get_account_tokennfttx`. Want to see all token flows? Run `get_account_tokentx`. It covers both sides of asset movement. - Full network picture. You can check the overall health using `get_stats_gnoprice` or use proxy tools like `proxy_gasprice` to calculate expected transaction costs before writing a single line of code. - Historical depth. Don't just look at recent activity. Use `get_account_txlist` and `get_account_txlist_internal` together to build a complete timeline of an account’s interactions, including hidden contract calls. ## How It Works The bottom line is, you treat reading complex chain data like asking a simple question. 1. Subscribe to this MCP and provide your Gnosisscan API Key. 2. Tell your AI client what you need—for instance, 'Show me all the NFT transfers for address X'. 3. The agent calls the correct function, retrieves the raw blockchain data, and presents it back to you in a readable format. ## Frequently Asked Questions **How do I check multiple balances using get_account_balance_multi?** You pass a comma-separated list of addresses to the tool. It returns an array showing the current xDAI balance for every address in that single call. **Can I track both ERC20 and NFT transfers using get_account_tokennfttx?** No, those are separate tools. Use `get_account_tokentx` specifically for all ERC20 token movements, and use `get_account_tokennfttx` only for the unique ERC721/NFT transfer records. **What's the difference between get_account_txlist and get_account_txlist_internal?** Use `get_account_txlist` to see standard transactions (like simple transfers). Use `get_account_txlist_internal` when you need to trace complex, machine-to-machine calls within a contract. **Is proxy_gasprice the same as get_stats_gnoprice?** No. `get_stats_gnoprice` gives the current market price of GNO and xDAI. `proxy_gasprice` gives you an estimate of the operational cost (gas) needed to execute a transaction on the network. **When I run `get_contract_abi`, what should I do if the contract source code isn't fully verified?** The ABI still provides necessary function signatures. You use the ABI to understand exactly which functions exist and what parameters they require, even if the full source code isn't visible for inspection. **If a transaction fails, how can I interpret the result using `get_tx_status`?** The status field tells you immediately whether the contract execution failed or succeeded. If it reports failure, look at the associated error message for the specific reason why the call reverted. **Can I use `get_block_bytime` to analyze a historical period without knowing the exact block number?** Yes, you can. Providing a timestamp allows you to find the corresponding block number, which is essential when doing deep dives into events that happened weeks or months ago. **How do I filter specific actions from event data using `get_logs`?** You must specify both the contract address and a precise event signature in your query. This tells the MCP exactly which type of logged action you want to see, filtering out irrelevant network noise. **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.