# Polygonscan MCP for AI Agents AI Agent Connect

> Polygonscan MCP lets you query the Polygon blockchain directly. Ask your agent to check MATIC balances, track transaction history, and inspect smart contract source code without switching tabs. It turns complex on-chain data into conversational answers for your immediate use.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_mNF9vvQFRY8109YvE9ENARWWZSO0plXKvgAXC1n9/ai-agent-connect
- **Tags:** polygon, matic, block-explorer, web3, smart-contracts

## Description

This Connector bridges the gap between your workspace and the Polygon network, giving you direct access to on-chain data through natural language. Instead of constantly refreshing a block explorer and copying hex codes into your notes, you can just ask your agent to do the heavy lifting. You can pull real-time MATIC prices, check supply data, or dig into the logs of a specific transaction while you're actually writing code or drafting an analysis report. It makes the friction of blockchain auditing disappear by bringing the data to you. If you're tired of the manual overhead of jumping between different browser tabs to verify movements, this is how you keep your data current. It's one of the many tools you can find in the Vinkius catalog to keep your research accurate and your workflow moving without the typical data entry headache.

## Tools

### get_contract_abi
Pulls the ABI for verified smart contracts so you can interact with them programmatically.

### get_balance_multi
Checks the MATIC balances for a list of multiple addresses in one go.

### get_block_countdown
Shows the estimated time remaining until the next block is mined based on a block number.

### get_matic_price
Pulls the latest price of MATIC to keep your analysis current.

### get_matic_supply
Retrieves the total circulating supply of MATIC on the Polygon network.

### get_tx_receipt_status
Checks if a transaction was successful or if it failed during execution.

### get_balance
Retrieves the current MATIC balance for a single specific wallet address.

### get_block_no_by_time
Finds the specific block number associated with a given Unix timestamp.

### get_block_reward
Tells you the reward amount for a specific block on the Polygon network.

### get_contract_source_code
Fetches the verified source code for a smart contract for technical review.

### get_token_1155_tx
Lists all transfer events for ERC-1155 tokens to track multi-token assets.

### get_token_nft_tx
Lists ERC-721 NFT transfer events to monitor high-value digital assets.

### get_token_tx
Pulls the transfer history for ERC-20 tokens to track standard asset movements.

### get_tx_list_internal
Retrieves a list of internal transactions that aren't visible on the main transaction list.

### get_logs
Fetches the raw logs for a transaction or contract event for deeper debugging.

### get_tx_list
Pulls a list of normal transactions for a specific address or contract.

### get_tx_status
Provides the current execution status of a specific smart contract interaction.

## Prompt Examples

**Prompt:** 
```
What is the current MATIC balance of address 0x0000000000000000000000000000000000001010?
```

**Response:** 
```
I've checked the address. The current MATIC balance for 0x000...1010 is **15,240.45 MATIC**.
```

**Prompt:** 
```
List the last 5 normal transactions for address 0x123...
```

**Response:** 
```
I've pulled the recent history for that address. Here are the 5 latest transactions:

| Hash | Value | Status |
| :--- | :--- | :--- |
| 0xabc... | 50 MATIC | Success |
| 0xdef... | 10 MATIC | Success |
| 0xghi... | 100 MATIC | Success |
| 0xjkl... | 5 MATIC | Success |
| 0xmnp... | 20 MATIC | Success |
```

**Prompt:** 
```
Get the ERC-20 token transfer events for address 0x456...
```

**Response:** 
```
I've retrieved the ERC-20 transfers. Here are the most recent movements:

* **100 USDC** moved to 0x789...
* **500 LINK** moved to 0xabc...
* **200 WBTC** moved to 0xdef...
```

## Capabilities

### Check MATIC balances
Retrieve the current MATIC balance for one or many specific wallet addresses at once.

### Audit transaction history
Pull a list of normal and internal transactions for any wallet to see full activity.

### Track token movements
Monitor ERC-20, ERC-721, and ERC-1155 transfer events across the entire network.

### Inspect smart contracts
Fetch verified smart contract ABIs and source code for technical deep dives.

### Monitor network stats
Get real-time MATIC prices, supply data, and block rewards instantly.

## Use Cases

### Wallet Auditing
A researcher wants to know the total MATIC held by 10 different wallets. They ask the agent to use get_balance_multi and get a summary table.

### NFT Tracking
A collector wants to see recent ERC-721 transfers for a specific project. The agent uses get_token_nft_tx to list the latest moves.

### Contract Debugging
A dev needs the source code for a verified contract to check a logic flow. They ask the agent to pull it using get_contract_source_code.

### Price Analysis
An analyst wants to know the MATIC price and total supply before writing a report. The agent pulls these with get_matic_price and get_matic_supply.

## Benefits

- Stop manual tab switching by pulling MATIC balances and token history directly into your AI client.
- Speed up smart contract development by using get_contract_abi and get_contract_source_code to pull verified data.
- Track complex asset movements by monitoring ERC-20, ERC-721, and ERC-1155 events with get_token_tx, get_token_nft_tx, and get_token_1155_tx.
- Get instant network context with get_matic_price and get_matic_supply to keep your research accurate.
- Audit deep wallet activity by pulling internal transactions via get_tx_list_internal alongside normal ones.
- Verify transaction success quickly using get_tx_receipt_status and get_tx_status without opening the explorer.

## How It Works

The bottom line is you get real-time Polygon blockchain data directly inside your favorite AI client.

1. Subscribe to the Polygonscan MCP via the Vinkius catalog.
2. Input your Polygonscan API Key into the configuration settings.
3. Ask your AI client to pull any on-chain data you need using plain English.

## Frequently Asked Questions

**Can the Polygonscan MCP check my wallet balance?**
Yes, it can retrieve the MATIC balance for any specific address you provide. You just need to give the agent the wallet address.

**How do I track NFT transfers using Polygonscan MCP?**
You can ask your agent to list ERC-721 transfer events to see recent NFT movements. It can also handle ERC-1155 transfers.

**Can I see the source code of a smart contract?**
Yes, this Connector can pull verified source code and ABIs for technical analysis. This is great for developers auditing verified contracts.

**Does this work for internal transactions?**
It does. You can specifically request internal transaction logs that don't show up on the standard list, which is helpful for tracking complex DeFi movements.

**Can I get real-time MATIC prices?**
Yes, the Connector can pull the latest MATIC price and total supply data instantly to help with your market analysis.

**Is this for sending crypto?**
No, this is a read-only tool. It's for querying data, not for moving funds or signing transactions. You'll still need a wallet for that.

**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.