Polygonscan MCP. Query Polygon's blockchain state directly from your chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Polygonscan (Polygon Block Explorer) MCP Server queries the MATIC blockchain directly. Use this server to check wallet balances, track every type of token transfer (ERC-20, NFT, ERC-1155), and inspect smart contract source code—all through your AI client.
What your AI agents can do
Get balance
Retrieves the current MATIC balance for one specific blockchain address.
Get balance multi
Gets the total MATIC balance for a list of multiple addresses at once.
Get block countdown
Calculates and returns an estimated time until the next block, based on a given block number.
Get the current MATIC balance for one or many Polygon addresses.
List a wallet’s normal and internal transaction history, and check their final execution status.
Get lists of specific token transfers, including ERC-20, NFTs (ERC-721), and multi-standard tokens (ERC-1155).
Retrieve the full ABI or source code for verified smart contracts.
Access real-time MATIC price, total supply, and block timing data.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Polygonscan (Polygon Block Explorer): 17 Tools for Web3 Data
Query every aspect of the Polygon blockchain. Use these tools to fetch balances, audit transactions, and analyze contract code with simple prompts.
019e5d49get balance
Retrieves the current MATIC balance for one specific blockchain address.
019e5d49get balance multi
Gets the total MATIC balance for a list of multiple addresses at once.
019e5d49get block countdown
Calculates and returns an estimated time until the next block, based on a given block number.
019e5d49get block no by time
Determines which block number was active at a specific Unix timestamp.
019e5d49get block reward
Retrieves the MATIC reward amount associated with a given block number.
019e5d49get contract abi
Fetches the Application Binary Interface (ABI) for a verified smart contract address.
019e5d49get contract source code
Retrieves the original source code for a verified smart contract address.
019e5d49get logs
Fetches raw event logs associated with specific transactions or addresses.
019e5d49get matic price
Retrieves the latest recorded market price for MATIC.
019e5d49get matic supply
Calculates and returns the total circulating supply of MATIC on Polygon.
019e5d49get token 1155 tx
Lists all detected transfer events for ERC-1155 tokens across a given period or address.
019e5d49get token nft tx
Gets the list of historical transfer events specifically for ERC-721 (NFT) tokens.
019e5d49get token tx
Retrieves the transaction event history for standard ERC-20 tokens.
019e5d49get tx list
Fetches a list of all normal, user-initiated transactions on the network.
019e5d49get tx list internal
Retrieves a list of internal smart contract function calls and transfers.
019e5d49get tx receipt status
Checks the final processing status (success or failure) of a specific transaction receipt.
019e5d49get tx status
Confirms if a smart contract execution, triggered by a transaction, completed successfully.
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
Make Your AI Do More
Start with Polygonscan (Polygon Block 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
You gotta connect Polygonscan to your agent when you need real visibility into the MATIC blockchain. This server lets your AI client pull on-chain data using plain language, meaning you skip jumping between tabs or writing complex API calls just to check a balance or track a token.
Checking Balances and Network Status
You can instantly get the current MATIC balance for one specific address using get_balance, or you can pull the total MATIC balance across a bunch of addresses at once with get_balance_multi. For network metrics, the system provides the latest recorded market price for MATIC via get_matic_price and calculates the total circulating supply of MATIC on Polygon by calling get_matic_supply.
If you need to track time-based data, you can use get_block_no_by_time to find out which block number was active at a specific Unix timestamp. You'll also get an estimated time until the next block using get_block_countdown, and for historical context, it retrieves the MATIC reward amount associated with any given block number via get_block_reward.
Tracking Wallet Activity and Transactions
To audit a wallet, you can fetch all normal, user-initiated transactions on the network using get_tx_list, or you can pull a list of internal smart contract function calls and transfers with get_tx_list_internal. When checking transaction status, you've got two ways: use get_tx_status to confirm if a smart contract execution completed successfully, or check the final processing status—whether it succeeded or failed—of a specific transaction receipt using get_tx_receipt_status.
For deep activity logs, you can fetch raw event logs associated with specific addresses or transactions by calling get_logs.
Monitoring Token Transfers
Tracking tokens is where this server shines. You'll get the historical transfer events specifically for ERC-721 (NFT) tokens when you use get_token_nft_tx. For standard, fungible assets like ERC-20 tokens, you pull the entire transaction event history using get_token_tx. If you’re dealing with multi-standard tokens that support both NFTs and fungibles—like ERC-1155—you can list all detected transfer events across a given period or address via get_token_1155_tx.
Inspecting Smart Contracts
When you need to dig into the code, this server gets you what you need. You pull the full Application Binary Interface (ABI) for a verified smart contract address using get_contract_abi. If you want to see how the contract was originally built, you can retrieve the original source code by calling get_contract_source_code on any verified contract address.
How Polygonscan MCP Works
- 1 Subscribe to the server and provide your Polygonscan API Key.
- 2 Ask your AI client a question using natural language (e.g., 'What's the MATIC balance for this address?').
- 3 The agent selects the correct tool (
get_balance) and executes the query, returning structured data directly to you.
The bottom line is: your AI client handles the API calls; you just ask questions about Polygon's state.
Who Is Polygonscan MCP For?
Anyone who has to manually cross-reference blockchain data across multiple browser tabs—from crypto analysts auditing a suspicious wallet, to web3 developers pulling contract details into an IDE. If you spend time copy-pasting addresses and reading raw block explorers, this is for you.
Pulls specific data points—like a contract's ABI or transaction logs—directly into their coding environment to build applications.
Audits complex wallet movements and token distribution across multiple addresses using conversational prompts.
Checks personal balances or transaction statuses without leaving their primary workspace, making due diligence faster.
What Changes When You Connect
- Get balance data fast. Instead of opening a separate block explorer, you simply ask for the MATIC amount using
get_balanceorget_balance_multi. Done in one prompt. - Audit complex activity. You can list both normal transactions (
get_tx_list) and internal contract calls (get_tx_list_internal), giving you a complete view of wallet usage. - Track all token types. Don't just look at MATIC. Use
get_token_txfor USDC,get_token_nft_txfor art NFTs, orget_token_1155_txfor multi-standard assets—all from one chat window. - Understand contract logic. Need to know how a token moves? Use
get_contract_abiandget_contract_source_codebefore you write the integration code. - Check execution status instantly. Before trusting a transfer, use
get_tx_receipt_statusorget_tx_statusto confirm if the contract actually finished running as expected.
Real-World Use Cases
Checking for Smart Contract Failures
A user sees a transaction but isn't sure if it completed. They prompt: 'Check the status of TX hash X.' The agent runs get_tx_receipt_status and tells them immediately if the contract execution failed, saving them from wasting time on dead-end data.
Forensic Token Tracking
An analyst needs to track a specific asset type. They ask: 'Show me all ERC-721 transfers for this wallet.' The agent uses get_token_nft_tx, providing the exact history of unique digital assets without manual filtering.
Quick Multi-Wallet Audit
A developer needs to verify collateral across five different accounts. They use get_balance_multi with a list of addresses, getting all MATIC balances in one single API call instead of running five individual checks.
Verifying Token Distribution
A team needs to know the total supply and current market value. They ask for 'MATIC total supply and price.' The agent runs get_matic_supply and get_matic_price, giving them immediate macro data.
The Tradeoffs
Confusing Logs with Transactions
The user just asks for 'all events.' This is too vague. They might get a massive dump of raw, unfiltered logs using get_logs that are impossible to read.
→
You need context. Instead, specify the transaction ID and use get_logs—or better yet, check the specific token type first with get_token_tx or get_token_nft_tx. That narrows the scope right away.
Manual Balance Checks
Copying 10 addresses and opening 10 separate tabs on a block explorer to check their balances.
→
Use get_balance_multi. Feed it all 10 addresses in one go, and the agent returns them all in a single, readable list.
Missing Contract Context
Trying to interpret transaction logs without knowing what contract the funds belonged to.
→
Always grab the context first. Run get_contract_abi or get_contract_source_code. This shows you exactly what the smart contract is built to do before analyzing its activity.
When It Fits, When It Doesn't
Use this server if your job requires knowing the state of Polygon, not just seeing a history. If you need an address's current MATIC value or total token ownership, start with get_balance or get_token_1155_tx. Don't use it if you only need general market news—use a dedicated financial API instead. You must choose your tools carefully: use get_logs when you suspect raw event data is missing from the main transaction list, but always cross-reference with get_tx_receipt_status to validate that the event actually succeeded. Never assume all token movements are ERC-20; if it's an NFT or a multi-standard asset, you must run get_token_nft_tx or get_token_1155_tx, respectively.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Polygonscan. 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
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 17 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Checking crypto balances used to require opening six different tabs.
You used to have to visit a block explorer, find the address, load the 'Balances' tab for MATIC, then open another section for ERC-20 tokens, and maybe check the NFT gallery. If you were tracking five wallets, that meant fifteen clicks, plus copy-pasting addresses everywhere.
Now? You just tell your agent: 'Give me the MATIC balance and all token counts for these 5 addresses.' The agent runs `get_balance_multi`, pulls everything together, and gives you a clean table. That's it.
Polygonscan (Polygon Block Explorer) MCP Server: Track every asset type.
Before, if you wanted to audit token movements—say, an NFT transfer—you were limited by the main transaction list. You'd see a generic 'transfer' event and then spend time digging through raw logs trying to figure out which specific contract governed that asset.
Now, with `get_token_nft_tx` or `get_token_1155_tx`, you get filtered lists designed for those assets. The agent handles the complex filtering so you just see what matters.
Common Questions About Polygonscan MCP
How do I check multiple MATIC balances using get_balance_multi? +
You pass a list of addresses (e.g., ['addr1', 'addr2', 'addr3']) to the get_balance_multi tool. It returns the current MATIC balance for every address in that batch.
What's the difference between get_logs and get_token_tx? +
get_logs gets all raw event data tied to a transaction, which is messy. get_token_tx specifically filters those logs down to show only standard ERC-20 token transfers, making it much cleaner.
Can I check if a smart contract call succeeded? Use get_tx_status. +
Yes. get_tx_status checks the final execution status of a specific contract function call. This is better than just checking the raw transaction list because it confirms successful state change.
Which tool do I use to find out what kind of tokens are involved? +
Use get_token_1155_tx for multi-standard assets, get_token_nft_tx for unique NFTs (ERC-721), and get_token_tx for standard ERC-20 tokens.
What do I need to authenticate when using any of the blockchain data query tools? +
You must provide your Polygonscan API Key. This key authorizes your AI client to pull data from the blockchain, making it mandatory for every call you execute. Don't forget this step; without it, none of the tools will run.
When should I use get_tx_list_internal instead of get_tx_list? +
Use get_tx_list_internal when you need to trace funds moved within a contract's execution. The standard list (get_tx_list) only shows the top-level transactions, but internal logs give you the deeper activity.
How do I find out what block number corresponds to a specific date? +
Use the get_block_no_by_time tool. You pass in the timestamp, and it returns the associated block number. This lets you map historical dates directly to the blockchain ledger structure.
Are there limits if I use a tool like get_token_tx repeatedly? +
Yes, external API usage often has rate limits. If your agent hits a limit, it will receive an error code. You'll need to handle that specific error in your workflow or wait before trying again.
Can I check the MATIC balance of multiple addresses at once? +
Yes! Use the get_balance_multi tool by providing a comma-separated list of addresses. The agent will return the balance for each one in a single response.
How do I see the NFT transfers for a specific wallet? +
You can use the get_token_nft_tx tool. Just provide the wallet address, and the agent will list the ERC-721 token transfer events associated with it.
Is it possible to retrieve the ABI of a smart contract? +
Absolutely. Use the get_contract_abi tool with the contract's address. If the source code is verified on Polygonscan, the agent will return the full ABI.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Curve Fitting Engine
Perform exact Linear and Polynomial regression on scatter plot data local. Get mathematically perfect coefficients, equations, and R-squared scores.
Crafter CMS
Manage headless content via Crafter CMS — execute GraphQL queries, write Git-based XML content, and publish to delivery engines directly from any AI agent.
FlowiseAI
Build LLM orchestration flows visually with a drag-and-drop interface for creating AI chatbots, agents, and RAG pipelines.
You might also like
Fusion Operations
Optimize factory floor operations with real-time production tracking, worker scheduling, and quality control automation.
Datanyze
Equip your AI agent to retrieve B2B lead intelligence, technographics, and company insights via the Datanyze API.
AppGallery Connect
Manage your AppGallery Connect apps via AI — check stats, submit builds for review, monitor ratings, and reply to user comments.