# FtmScan MCP for AI Agents AI Agent Connect

> FtmScan (Fantom Network Explorer) MCP gives your AI agent direct access to the Fantom blockchain. You can query wallet balances, track token transfers, inspect smart contract source code, and monitor transaction statuses in real-time. It turns your AI into a blockchain explorer for the Fantom network.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_pTTw1YuQ3CLwsgnovwArQp6hu1wrfnVQtLvNG5Ps/ai-agent-connect
- **Tags:** fantom, ftmscan, smart-contracts, web3, blockchain-explorer

## Description

This Connector gives your AI agent a direct line into the Fantom network. Instead of you having to manually navigate through a web explorer to find specific data, your agent can pull the information you need through a simple conversation. You can ask it to check the balances of multiple wallets at once, track how specific tokens are moving across the network, or even pull the verified source code for a smart contract you're investigating. It takes the friction out of on-chain research by making the data accessible in the same place you're already working.

If you're a developer, you can use it to quickly verify a contract's ABI or inspect its logic without switching windows. For analysts, it's a way to monitor token supplies and price movements in real time. It handles the repetitive tasks like fetching transaction receipts or listing internal transfers so you can focus on the actual analysis. Whether you're looking for NFT transfer events or trying to understand the internal flow of a decentralized application, the agent can surface those details instantly.

You can find this in the Vinkius catalog to get your AI client connected to the Fantom ecosystem. It's about moving from manual data hunting to a flow where your agent provides the facts as soon as you ask for them. You won't have to worry about copy-pasting hashes or refreshing pages to see if a transaction cleared. This connection turns your agent into a dedicated blockchain explorer that knows exactly where to look for Fantom network data.

## Tools

### get_erc20_token_balance
Checks the balance of a specific ERC20 token for an address. It's the fastest way to see how much of a specific asset someone holds.

### get_erc20_transfers
Lists all ERC20 token transfer events. This is great for tracking the movement of specific assets over time.

### get_erc721_transfers
Lists all ERC721 token transfer events. Use this to monitor NFT movements across the network.

### get_eth_block_number
Gets the latest block number on the network. This provides a snapshot of the current blockchain height.

### get_eth_transaction_by_hash
Fetches details for a specific transaction using its hash. Use this to see exactly what happened in a past event.

### get_ftm_balance_multi
Retrieves FTM balances for multiple addresses at once. This saves time when checking a list of several wallets.

### get_ftm_balance
Retrieves the FTM balance for a single address. This is your go-to for checking a specific wallet's main balance.

### get_ftm_last_price
Gets the current price of FTM. Use this to keep an eye on market movements in real time.

### get_transaction_status
Checks the current execution status of a transaction. Use this to see if a transaction is pending or failed.

### get_block_countdown
Provides the estimated time until the next block. This helps you gauge network speed and timing.

### get_block_reward
Retrieves the current block rewards. This gives you a look at the network's current incentive structure.

### get_contract_abi
Retrieves the Application Binary Interface for a specific smart contract. Use this to understand how to interact with a contract via your AI.

### get_contract_source_code
Fetches the verified source code of a deployed contract. This helps you audit the logic behind any on-chain project.

### get_erc20_token_supply
Retrieves the total supply of an ERC20 token. Use this to calculate the circulating supply of a project.

### get_ftm_total_supply
Retrieves the total supply of the FTM token. This helps you understand the overall economy of the network.

### get_internal_transactions
Lists internal transactions for an address. This is key for seeing how funds move between contracts.

### get_logs
Fetches event logs from the blockchain. This is useful for deep-diving into specific contract emissions.

### get_normal_transactions
Lists standard transactions for an address. Use this to see the general history of a wallet.

### get_transaction_receipt_status
Checks the final receipt status of a transaction. This tells you if a trade or mint actually went through.

## Prompt Examples

**Prompt:** 
```
What's the current balance for 0x1234567890abcdef1234567890abcdef12345678?
```

**Response:** 
```
I've checked that address on the Fantom network. Here is the current balance:

| Asset | Balance |
| :--- | :--- |
| **FTM** | 1,250.45 |
| **USDC** | 500.00 |

*Note: Balances are pulled in real-time from FtmScan.*
```

**Prompt:** 
```
Show me the last 3 transfers for that address.
```

**Response:** 
```
Here are the 3 most recent ERC-20 transfers for that wallet:

* **Token:** USDC | **Amount:** 50.00 | **Status:** Success
* **Token:** FTM | **Amount:** 10.00 | **Status:** Success
* **Token:** USDC | **Amount:** 5.00 | **Status:** Success
```

**Prompt:** 
```
Get the source code for the contract at 0x04068da6a83afcfa0e13ba15a6696662335d5b75.
```

**Response:** 
```
I've retrieved the verified source code for that contract. It is a SpookySwap LP token contract written in Solidity. 

```solidity
// [Source code snippet would appear here]
```
```

## Capabilities

### Fetch multi-address balances
Get FTM balances for several wallets at once to check portfolio holdings quickly.

### Track token transfers
Monitor ERC-20 and ERC-721 movements across the network to see how assets flow.

### Inspect smart contracts
Pull verified source code and ABIs for any deployed contract to audit logic.

### Verify transaction status
Check the execution receipts and status of specific hashes to see if a trade landed.

### Get network stats
Pull real-time FTM price, total supply, and block rewards for market context.

## Use Cases

### Auditing a new DEX
A developer asks the agent to pull the source code and ABI for a new pool to check for vulnerabilities.

### Whale Tracking
An analyst asks for a list of all ERC-20 transfers for a specific high-value wallet to see where the money went.

### Portfolio Check
A user asks for a summary of their FTM balance and the total supply of their favorite token.

### Transaction Debugging
A dev provides a hash and asks the agent to check the receipt status and internal transactions to see why a swap failed.

## Benefits

- Stop manual searching by using get_ftm_balance_multi to check several wallets in one go.
- Audit contracts faster with get_contract_source_code to see the logic without leaving your workspace.
- Track asset flow easily with get_erc20_transfers to see how tokens move across the Fantom network.
- Get instant market data using get_ftm_last_price to keep your analysis current.
- Verify transaction success with get_transaction_receipt_status to avoid guessing if a trade landed.

## How It Works

The bottom line is it turns your AI into a live blockchain explorer for the Fantom network.

1. Subscribe to the FtmScan MCP in the Vinkius catalog.
2. Enter your FtmScan API Key in the configuration settings.
3. Ask your AI client questions about Fantom blockchain data.

## Frequently Asked Questions

**Can FtmScan MCP check my NFT transfers?**
Yes, it can pull ERC-721 transfer events. This allows your agent to show you exactly when and where your NFTs moved across the Fantom network.

**Does FtmScan MCP work for other blockchains like Ethereum?**
No, this Connector is specifically built for the Fantom network. You will need a different explorer MCP if you are looking for Ethereum or other chain data.

**How do I get my FtmScan API key for this Connector?**
You can get your API key directly from the FtmScan website. Once you have it, just add it to your Connector configuration to start querying data.

**Can FtmScan MCP see internal transactions?**
Yes, it can fetch internal transactions. This is very useful for seeing how funds move between different smart contracts rather than just simple wallet-to-wallet transfers.

**Is FtmScan MCP good for developers auditing smart contracts?**
It's a great tool for developers. It allows your agent to pull verified source code and ABIs directly, making it much faster to audit contract logic.

**Can FtmScan MCP show me the current FTM price?**
Yes, it can pull the latest FTM price in real time. This helps you keep your analysis current without having to leave your AI client.

**Can I check the balance of multiple wallets at once?**
Yes, use the `get_ftm_balance_multi` tool with a comma-separated list of addresses. The agent will return the FTM balance for each address in the list.

**How do I see the source code of a smart contract?**
Use the `get_contract_source_code` tool with the contract's address. If the contract is verified on FtmScan, the agent will retrieve the source code and metadata.

**How can I verify if a transaction was successful?**
Use the `get_transaction_status` tool with the transaction hash. It will return the execution status code directly from the Fantom network.