Gnosisscan MCP. Analyze asset flows and contract state from the chat.

Q: How do I check multiple balances with the getaccountbalancemulti tool?

Pass a list of addresses to getaccountbalancemulti. It runs the query for every address and returns the xDAI balance for each one in a single response.

Q: Is getaccounttxlistinternal better than getaccounttxlist?

Yes, getaccounttxlistinternal is better for debugging. It shows internal transactions, which reveal the underlying contract calls and are crucial for understanding complex state changes that getaccounttxlist misses.

Q: Can I get the contract ABI using getcontractabi?

Yes, you provide the contract address, and getcontractabi returns the full ABI. This is what you need to know what functions the contract supports.

Q: What is the best tool for checking NFT transfers?

Use getaccounttokennfttx. This tool specifically tracks ERC721 (NFT) transfer events for an address or contract, keeping NFT history separate from standard token movements.

Q: How do I get the price of Gnosis (GNO) and xDAI?

Run getstatsgnoprice. This tool fetches the last recorded price for both GNO and xDAI, giving you current market context for your analysis.

Q: How do I use the getaccounttokennfttx tool to find NFT transfers?

Use getaccounttokennfttx to list ERC721 transfer events for a specific address. This tool pulls all NFT transfer data, letting you track specific assets or check an entire portfolio's movement history.

Q: Can I check the status of a transaction using gettxstatus?

Yes, gettxstatus checks the contract's execution status. This tells you if the transaction ran correctly or if it failed, which is crucial for debugging smart contract interactions.

Q: What information does getaccounttxlist provide for an address?

getaccounttxlist provides a list of normal transactions for an address. You get a basic view of the transaction history, including the hash and basic details, without delving into internal contract calls.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

Just plug in your AI agents and start using Vinkius.

Gnosisscan (Gnosis Chain Explorer) MCP Server. Query Gnosis Chain data directly from your AI client. Check xDAI balances, trace ERC20 and NFT transfers, list transaction history, and fetch contract source code without leaving your chat.

It lets you analyze asset flows and contract states using natural language prompts.

What your AI agents can do

Get account balance

Gets the xDAI balance for one specific address.

Get account balance multi

Gets the xDAI balance for a list of addresses.

Get account minedblocks

Gets a list of block numbers validated by a specific address.

+ 23 more capabilities included

Check xDAI Balances

Retrieve the current xDAI balance for one or many specific addresses on the Gnosis Chain.

Track Token Movements

List all ERC20 (token) and ERC721 (NFT) transfer events linked to an address or contract.

Audit Transaction History

Fetch detailed lists of normal and internal transactions for any given wallet address.

Analyze Contract Code

Get the Application Binary Interface (ABI) and verified source code for smart contracts.

Monitor Network Status

Retrieve real-time data points like gas prices, block rewards, and total asset supply.

Ask AI about this MCP

Ask ChatGPT

Ask Claude

Ask Perplexity

Supported MCP Clients

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

Gets the receipt details for a transaction hash.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

Import from OpenAPI, Swagger, or YAML specs
Create Agent Skills with progressive disclosure
Deploy to edge with MCPFusion framework
Built in DLP, auth, and compliance on every call
Real time usage dashboard and cost metering
Publish to catalog or keep private

Start building

Make Your AI Do More

Start with Gnosisscan (Gnosis Chain Explorer), then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.

Use this MCP plus 4,700+ others, all in one place
Add new capabilities to your AI anytime you want
Every connection is secured and compliant automatically
Track usage and costs across all your servers
Works with Claude, ChatGPT, Cursor, and more
New servers added to the catalog every week

What you can do with this MCP connector

Gnosisscan (Gnosis Chain Explorer) lets your AI client query the Gnosis Chain directly. You'll check xDAI balances, trace ERC20 and NFT movements, list transaction history, and grab contract source code—all from your chat. It lets you analyze asset flows and contract states using plain language prompts.

Getting Balances and Tracking Tokens

get_account_balance checks the xDAI balance for one address. get_account_balance_multi checks the xDAI balance for a list of addresses. get_account_tokentx lists ERC20 token transfers for an address. get_account_tokennfttx lists NFT (ERC721) transfers for an address. get_account_txlist lists normal transactions for an address. get_account_txlist_internal lists internal transactions for an address.

Contract and Code Analysis

get_contract_abi gets the Application Binary Interface (ABI) for a smart contract, which is based on its verified source code. get_contract_sourcecode fetches the actual source code for a verified smart contract. get_logs retrieves event logs emitted by a smart contract or transaction. proxy_getcode gets the bytecode of a contract using a proxy. proxy_getstorageat gets the value stored at a specific address or key using a proxy. proxy_call executes a read-only call to a contract function. proxy_gettransactionbyhash gets transaction details using a transaction hash proxy. proxy_gettransactionreceipt gets the receipt details for a transaction hash. proxy_estimategas estimates the gas needed for a contract function call. proxy_gasprice gets the current gas price for the network. proxy_getblockbynumber gets full block details using a block number proxy. get_account_minedblocks lists block numbers validated by a specific address. get_block_bytime gets the block number based on a specific timestamp. get_block_countdown gets an estimated time until the next block is mined. get_block_reward gets the block reward amount for a given block number. get_stats_ethsupply gets the total supply amount of xDAI on the Gnosis Chain. get_stats_gnoprice fetches the last recorded price for Gnosis (GNO) and xDAI. get_tx_status checks the execution status of a contract transaction. get_tx_receiptstatus checks the current status of a transaction receipt. proxy_blocknumber gets the current block number using the eth_blockNumber proxy. get_account_txlist lists normal transactions for an address. get_account_txlist_internal lists internal transactions for an address. get_account_tokentx lists ERC20 token transfer events for an address. get_account_tokennfttx lists NFT (ERC721) transfer events for an address. get_account_balance gets the xDAI balance for one specific address. get_account_balance_multi gets the xDAI balance for a list of addresses.

How Gnosisscan MCP Works

1 Subscribe to the Gnosisscan server and input your unique Gnosisscan API Key.
2 Prompt your AI client with a request (e.g., 'What is the NFT history for address X?').
3 The agent executes the necessary tool (e.g., get_account_tokennfttx) and returns the structured data to your chat.

The bottom line is, you talk to your AI client, and it handles the complex queries against the Gnosis Chain APIs.

Who Is Gnosisscan MCP For?

This is for the Web3 Developer, the DeFi Analyst, and the Smart Contract Auditor. If your job involves moving assets, tracking state changes, or debugging smart contracts on Gnosis Chain, you need this. It cuts out the need to jump between block explorers and code IDEs.

Web3 Developer

Uses get_contract_abi and get_contract_sourcecode to validate contract functions or check transaction receipts without switching to a web browser.

DeFi Analyst

Runs get_account_balance_multi to aggregate and compare token movements across dozens of addresses in a single chat session.

Blockchain Auditor

Employs get_account_txlist_internal to trace complex, multi-step contract interactions and internal call chains.

What Changes When You Connect

Audit multiple wallets at once. Use get_account_balance_multi to check xDAI balances for a whole list of addresses, saving you from running dozens of individual queries.
Trace every asset movement. get_account_tokentx handles ERC20 transfers, and get_account_tokennfttx tracks NFT (ERC721) movements, keeping your portfolio history clean.
Go deep on smart contracts. Fetch verified contract source code or the ABI using get_contract_abi. You get the raw functions needed for development testing.
Understand transaction complexity. Don't just check the balance. Use get_account_txlist_internal to see the internal calls that explain why a transaction happened.
Stay informed on network health. Need to know gas cost? Use proxy_gasprice or get_stats_gnoprice to get current network metrics right where you are working.

Real-World Use Cases

Debugging a failed DeFi interaction

A developer needs to know why a user's funds disappeared. They ask their agent to run get_account_txlist_internal on the target address. The agent returns the internal call chain, showing the exact contract interaction that failed, allowing the developer to pinpoint the bug instantly.

Portfolio Reconciliation

A data analyst needs to compare the xDAI balances across 50 different client wallets. They use get_account_balance_multi to pull all 50 balances in one go, aggregating the data point without opening 50 browser tabs.

Verifying a Smart Contract's Logic

A developer wants to know if a contract supports a specific function. They run get_contract_abi on the contract address. The agent returns the full ABI, letting the developer validate the required function signatures against the contract's capabilities.

Checking Transaction Finality

A user sent a large transaction and needs to know if it completed. They run get_tx_receiptstatus using the transaction hash. The agent immediately tells them if the transaction is pending, successful, or failed, eliminating the need to check a separate explorer page.

The Tradeoffs

Treating all transactions the same

Seeing a transaction list and assuming it only shows simple transfers. This misses crucial internal contract calls that explain the true flow of funds.

→ Always check the internal activity. Use get_account_txlist_internal to see the full, complex transaction graph, not just the top-level calls.

Over-relying on proxies

Using proxy_gettransactionbyhash when you just need a list of recent activity. This is too granular and doesn't provide the necessary context of the user's current activity.

→ Start broad. Use get_account_txlist or get_account_txlist_internal first. Only use the proxy tools when you have a specific hash or block number to investigate.

Manual data aggregation

Copying 50 different account addresses and pasting them one by one into a web explorer to check balances.

→ Pass the entire list of addresses to get_account_balance_multi. It handles the batch query and returns structured data instantly.

When It Fits, When It Doesn't

Use this server if your goal is deep, programmatic analysis of blockchain state. You need to know why funds moved, not just that they moved. If you only need a simple balance check, get_account_balance is enough. But if you're debugging a smart contract interaction, you need the full suite: use get_account_txlist_internal to see the flow, then get_contract_abi to understand the contract rules, and finally get_account_tokentx to track the resulting token change. Don't use this if you're just browsing the chain—use this when you're writing code or auditing data. If you only need to know the gas price, proxy_gasprice is simpler. This is for the heavy lifting.

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Gnosisscan. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

How we secure it →

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This server provides 26 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.

Available Capabilities

get_account_balance get_account_balance_multi get_account_minedblocks get_account_tokennfttx get_account_tokentx get_account_txlist get_account_txlist_internal get_block_bytime get_block_countdown get_block_reward get_contract_abi get_contract_sourcecode get_logs get_stats_ethsupply get_stats_gnoprice get_tx_receiptstatus get_tx_status proxy_blocknumber proxy_call proxy_estimategas proxy_gasprice proxy_getblockbynumber proxy_getcode proxy_getstorageat proxy_gettransactionbyhash proxy_gettransactionreceipt

Sifting through block explorers is a nightmare.

Right now, figuring out what happened with an address means opening the block explorer. You click the address, find the transactions tab, then you have to scroll through dozens of entries. You copy hashes, you switch tabs to check the status, and you often have to guess which data point matters most.

With the Gnosisscan MCP Server, you just ask your agent. You say, 'Show me the internal transfers for this address.' The agent runs `get_account_txlist_internal` and gives you the complete, structured data set, right in your chat. No clicking, no tabs, just answers.

Gnosisscan MCP Server: Track asset flows and contract states.

You no longer have to manually run queries for balances, then separately query for token movements, and then look up the contract ABI. You can ask the agent to combine these steps: 'What was the balance change and what tokens moved during the last 10 transactions for address X?'

The difference is control. You get the full, linked data set in one go. You stop being a data collector and start being an analyst.

Common Questions About Gnosisscan MCP

How do I check multiple balances with the get_account_balance_multi tool? +

Pass a list of addresses to get_account_balance_multi. It runs the query for every address and returns the xDAI balance for each one in a single response.

Is get_account_txlist_internal better than get_account_txlist? +

Yes, get_account_txlist_internal is better for debugging. It shows internal transactions, which reveal the underlying contract calls and are crucial for understanding complex state changes that get_account_txlist misses.

Can I get the contract ABI using get_contract_abi? +

Yes, you provide the contract address, and get_contract_abi returns the full ABI. This is what you need to know what functions the contract supports.

What is the best tool for checking NFT transfers? +

Use get_account_tokennfttx. This tool specifically tracks ERC721 (NFT) transfer events for an address or contract, keeping NFT history separate from standard token movements.

How do I get the price of Gnosis (GNO) and xDAI? +

Run get_stats_gnoprice. This tool fetches the last recorded price for both GNO and xDAI, giving you current market context for your analysis.

How do I use the `get_account_tokennfttx` tool to find NFT transfers? +

Use get_account_tokennfttx to list ERC721 transfer events for a specific address. This tool pulls all NFT transfer data, letting you track specific assets or check an entire portfolio's movement history.

Can I check the status of a transaction using `get_tx_status`? +

Yes, get_tx_status checks the contract's execution status. This tells you if the transaction ran correctly or if it failed, which is crucial for debugging smart contract interactions.

What information does `get_account_txlist` provide for an address? +

get_account_txlist provides a list of normal transactions for an address. You get a basic view of the transaction history, including the hash and basic details, without delving into internal contract calls.

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.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python