# Harmonyscan MCP for AI Agents AI Agent Connect

> Harmonyscan MCP. Access Harmony One blockchain data like balances, transactions, and smart contract source code directly through your AI agent. It pulls real-time data from the Harmony One network so you don't have to flip between tabs or manual block explorers.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_hCFVIwT7pV7N02KfZ6z0UBU5q1pzYMKhyLIS3MJh/ai-agent-connect
- **Tags:** harmony-one, block-explorer, web3, smart-contracts, crypto-api

## Description

Harmonyscan lets you connect your AI agent to the Harmony One blockchain. This Connector gives your agent the ability to pull real-time data from the network without you having to manually search a block explorer. You can ask it to check wallet balances, list transaction history, or pull the source code for smart contracts. It handles the heavy lifting of querying the blockchain so you can stay focused on your work. Because Vinkius hosts this, you can plug it into your existing setup and treat your AI like a dedicated blockchain analyst. Whether you're debugging a contract or tracking token movements, your agent gets the facts instantly.

## Tools

### get_one_supply
Fetches the total circulating supply of ONE. This helps you understand the current tokenomics of the network.

### get_source_code
Grabs the verified source code for a specific smart contract. It makes auditing and reviewing on-chain code much faster.

### get_tx_list_internal
Pulls a list of internal transactions from the blockchain. This shows you what's happening behind the scenes in complex smart contract calls.

### get_tx_list
Lists normal transactions for a specific address. Use it to see the history of standard movements on the network.

### get_tx_receipt_status
Verifies the receipt status of a transaction. This confirms whether a transaction was actually recorded on the blockchain.

### proxy_request
Executes standard JSON-RPC methods via a proxy. This lets you run custom queries that aren't covered by other tools.

### get_status
Checks the execution status of a specific transaction hash. Use this to see if a transaction succeeded or failed.

### get_token_tx
Lists recent HRC20 token transfer events. It's the best way to track specific token movements across the chain.

### get_abi
Fetches the Application Binary Interface for a smart contract. You'll need this to interact with the contract using your own code.

### get_balance_multi
Gets the ONE balance for multiple addresses in one go. This saves a lot of time when checking a list of wallets.

### get_balance
Retrieves the ONE balance for a single address. Use it for quick, one-off wallet balance checks.

### get_block_reward
Gets the rewards for a specific block. This helps you monitor the health and activity of the Harmony One network.

### get_logs
Pulls event logs from the blockchain. This is useful for debugging how smart contracts interact with other protocols.

### get_one_price
Retrieves the current market price for the ONE token. Use it to get real-time price data for your analysis.

## Prompt Examples

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

**Response:** 
```
The current balance for that address is **1,250.45 ONE**.
```

**Prompt:** 
```
List the last 5 HRC20 token transfers for address 0x123...
```

**Response:** 
```
I've found the 5 most recent HRC20 transfers. They include:

*   **100 VIPER tokens** received yesterday
*   **50 FOX tokens** sent 2 hours ago

Would you like the full details for any of these?
```

**Prompt:** 
```
Get the ABI and source code for the contract at 0x0809D4A52411430218Af7a6d8f17513E99770059.
```

**Response:** 
```
I have retrieved the verified source code and ABI for the contract. It is a **'ViperSwap'** liquidity pool contract compiled with Solidity 0.6.12. I can now help you analyze its functions or events.
```

## Capabilities

### Fetch wallet balances
Get the ONE balance for a single wallet or multiple addresses at once.

### Track transaction history
List normal, internal, and HRC20 token transfers with full metadata.

### Pull smart contract code
Retrieve verified source code and ABIs for on-chain contracts.

### Monitor network stats
Get real-time data on ONE supply, block rewards, and current prices.

### Verify transaction status
Check the execution and receipt status for any transaction hash.

## Use Cases

### Debugging a smart contract
A developer needs to check a contract's ABI and asks their agent to pull it from a specific address to debug an integration.

### Tracking whale movements
A crypto analyst wants to see if a large amount of tokens moved and asks for the last 5 HRC20 transfers.

### Verifying swap success
A DeFi user wants to know if their transaction went through and asks the agent to check the receipt status.

### Analyzing tokenomics
A researcher wants to see the total supply of ONE and asks for the latest network stats and block rewards.

## Benefits

- Stop switching tabs by fetching balances and prices directly in your chat using get_balance and get_one_price.
- Speed up your dev workflow by pulling contract ABIs and source code with get_abi and get_source_code.
- Track token movements more accurately by listing HRC20 transfers with get_token_tx.
- Monitor network health instantly with get_one_supply and get_block_reward.
- Confirm transaction success immediately using get_status and get_tx_receipt_status.

## How It Works

The bottom line is you get direct blockchain data inside your AI chat without leaving your workspace.

1. Subscribe to the Harmonyscan MCP via the Vinkius catalog.
2. Enter your Harmonyscan API Key in the configuration settings.
3. Ask your AI client to check a wallet balance, list transactions, or fetch contract code.

## Frequently Asked Questions

**Does Harmonyscan MCP support Harmony One balances?**
Yes, it lets your agent fetch the ONE balance for a single wallet or multiple addresses at once.

**Can I use it to check my transaction status?**
You can ask your agent to verify if a transaction was successful or check its receipt status using the network data.

**How do I get contract source code?**
Your agent can pull verified source code and ABIs directly from the Harmony One blockchain using the Connector.

**Can it track HRC20 tokens?**
Yes, it can list HRC20 token transfer events so you can track specific token movements.

**Is there a way to see internal transactions?**
This Connector can pull internal transactions, which are often missed by standard block explorers.

**Does it provide real-time ONE prices?**
Yes, your agent can pull the current market price and total supply for the ONE token.

**Can I check the balance of multiple Harmony addresses at once?**
Yes! Use the `get_balance_multi` tool and provide a comma-separated list of addresses (up to 20). The agent will return the ONE balance for each address in a single response.

**How do I verify if a specific transaction was successful or failed?**
You can use the `get_status` tool with the transaction hash. It returns a status code where '1' indicates success and '0' indicates failure, along with any available error messages.

**Is it possible to retrieve the source code of a smart contract?**
Yes, provided the contract is verified on Harmonyscan. Use the `get_source_code` tool with the contract address to get the Solidity source code, compiler version, and optimization settings.