Harmonyscan MCP. Analyze Harmony blockchain data directly from your agent.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Harmonyscan (Harmony One Block Explorer API) lets your AI agent query the Harmony blockchain. Get live data on ONE balances, check transaction history (normal, internal, and HRC20 tokens), and audit smart contracts.
Use tools like `get_abi` and `get_source_code` to analyze contract logic and track network metrics like total ONE supply and current price.
What your AI agents can do
Get abi
Retrieves the Application Binary Interface (ABI) for a specified smart contract.
Get balance
Gets the current ONE balance for a single wallet address.
Get balance multi
Gets the ONE balance for a list of multiple wallet addresses.
Check the ONE balance for one or multiple wallet addresses using get_balance or get_balance_multi.
Pull transaction lists, including normal transfers (get_tx_list), internal calls (get_tx_list_internal), and specific HRC20 token movements (get_token_tx).
Get a contract's full source code (get_source_code) or its Application Binary Interface (ABI) using get_abi.
Fetch the total supply of ONE (get_one_supply), the current market price (get_one_price), or the block reward amount (get_block_reward).
Confirm if a transaction executed successfully and retrieve its receipt status using get_status or get_tx_receipt_status.
Run standard JSON-RPC methods for advanced interactions using the proxy_request tool.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Harmonyscan (Harmony One Block Explorer API): 14 Tools
This server gives your AI agent 14 tools to analyze the Harmony One blockchain. You can check everything from token balances to contract source code.
019e5d22get abi
Retrieves the Application Binary Interface (ABI) for a specified smart contract.
019e5d22get balance
Gets the current ONE balance for a single wallet address.
019e5d22get balance multi
Gets the ONE balance for a list of multiple wallet addresses.
019e5d22get block reward
Retrieves the current block reward amount for the network.
019e5d22get logs
Fetches all event logs generated by a contract for a given address.
019e5d22get one price
Retrieves the latest market price for the ONE token.
019e5d22get one supply
Gets the total circulating supply of the ONE token.
019e5d22get source code
Retrieves the verified source code written for a smart contract.
019e5d22get status
Checks the execution status of a given transaction hash.
019e5d22get token tx
Retrieves a list of transfers for HRC20 tokens on the network.
019e5d22get tx list
Lists all standard transactions that occurred on the network.
019e5d22get tx list internal
Lists transactions that are internal calls within the blockchain structure.
019e5d22get tx receipt status
Checks the detailed receipt status of a transaction.
019e5d22proxy request
Executes custom JSON-RPC calls against the blockchain using a provided method and parameters.
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 Harmonyscan (Harmony One Block Explorer API), 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
Listen up. This Harmonyscan API lets your AI agent dig deep into the Harmony blockchain. You'll get live data on ONE balances, check transaction history (normal, internal, and HRC20 tokens), and audit smart contracts.
Check Account Balances
To see a wallet's ONE balance, use get_balance. If you've got a bunch of addresses, get_balance_multi checks them all out for you.
Trace Transactions
Pulling transaction lists is easy. Use get_tx_list to grab all standard transactions, get_tx_list_internal for internal calls, and get_token_tx for HRC20 token movements. You can also check the detailed receipt status with get_tx_receipt_status or just see if a transaction went through using get_status.
Analyze Contract Code
Need to know what a smart contract does? Use get_source_code to get its full verified code, or use get_abi to grab the Application Binary Interface. You can also run any custom JSON-RPC call against the blockchain using proxy_request.
Monitor Network Metrics
Keep tabs on the network with get_one_supply to see the total circulating ONE supply, get_one_price for the latest market price, or get_block_reward to know the current block reward amount.
Execute Commands
Your agent can also fetch all event logs generated by a contract for a specific address using get_logs; you'll get a full picture of what's going down. You'll also get a list of transfers for HRC20 tokens using get_token_tx.
How Harmonyscan MCP Works
- 1 Subscribe to the Harmonyscan server and provide your API Key.
- 2 Your AI agent receives a request (e.g., 'Check the contract at 0x...').
- 3 The agent maps the request to the right tool (e.g.,
get_abi) and runs it. You get the structured blockchain data back.
The bottom line is, your AI agent handles all the API calls and data parsing, letting you focus on the insight, not the execution.
Who Is Harmonyscan MCP For?
Crypto analysts and web3 developers who deal with contract logic and token flows daily. This is for the person who needs to track whale movements or validate a contract's source code without leaving their IDE. It cuts out hours of manual block explorer clicking.
Quickly fetching contract ABIs and source code directly in the IDE for integration testing and auditing.
Automating the tracking of token transfers and wallet movements across the Harmony ecosystem.
Checking transaction statuses and monitoring asset liquidity to validate product functionality.
What Changes When You Connect
- Stop manually navigating block explorer tabs. Use
get_balanceorget_balance_multito fetch ONE balances for any address instantly, without leaving your workflow. - Audit contracts with confidence. Call
get_abiandget_source_codeto retrieve verified contract source and ABI, letting you confirm the underlying logic before deployment. - Track every token movement. Use
get_token_txto pull specific HRC20 token transfer events, isolating them from general transaction noise. - Get the big picture metrics. Call
get_one_supplyandget_one_priceto get the current total supply and market price, giving you immediate economic context. - Debug failed transactions fast. Use
get_statusorget_tx_receipt_statusto verify execution and see exactly why a transaction failed. - Handle anything. The
proxy_requesttool lets you execute any standard JSON-RPC method, ensuring coverage for complex, non-standard queries.
Real-World Use Cases
Validating a new DeFi protocol
A product manager needs to confirm a protocol's liquidity. They ask their agent: 'What is the total ONE supply, and what are the last 10 HRC20 transfers for this contract?' The agent runs get_one_supply and get_token_tx, providing immediate, structured data for validation.
Investigating a suspicious wallet
A crypto analyst tracks a suspicious address. They prompt their agent: 'List all transactions for this address, and get its current ONE balance.' The agent runs get_balance and get_tx_list, giving a complete history and current state in one go.
Checking contract security
A developer needs to integrate with a new contract. They ask the agent: 'Get the source code and ABI for 0x...' The agent uses get_source_code and get_abi, allowing the developer to verify the contract logic before writing a single line of integration code.
Debugging a failed smart contract call
A user sends a transaction that fails. They ask the agent: 'Check the status of this transaction hash.' The agent uses get_status and get_tx_receipt_status to provide the exact failure reason and receipt details.
The Tradeoffs
Confusing transaction types
A user tries to check token transfers by running get_tx_list and then filtering manually for token amounts. This is messy and misses internal calls.
→
Don't rely on general lists. Use get_token_tx specifically for HRC20 token transfers, and use get_tx_list_internal to catch any hidden internal calls.
Over-querying basic state
Checking the balance for 10 addresses by running get_balance 10 separate times in a loop. This is slow and inefficient.
→
Use get_balance_multi to pass a list of all addresses in one call. It's faster and keeps your agent's prompt clean.
Ignoring contract details
Assuming a contract works just because it's deployed. You might miss crucial logic or ABI details.
→
Always start by calling get_abi and get_source_code to understand the contract's official structure and logic. This is the first step.
When It Fits, When It Doesn't
Use this server if your workflow requires deep, structured data retrieval from the Harmony blockchain. You need to know what the state is (get_balance, get_one_supply) and what happened (get_tx_list, get_logs). Don't use this if you just need a simple, human-readable summary of the network's general health—you'll need a different data feed. If you only need to check a single, public address's current balance, get_balance is fine, but if you need to check 50 addresses, get_balance_multi is required. Always use get_abi when interacting with a contract's functions, not just its address.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Harmonyscan. 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 14 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually checking every transaction on a blockchain is a nightmare.
Before this, checking a contract's history meant hopping between the main transaction list, the token transfer tab, and the internal calls section. You had to manually copy addresses, jump to the block explorer, and cross-reference three different views just to build a single picture of activity.
Now, your AI agent does it. You ask for the transaction history, and it runs `get_tx_list`, `get_tx_list_internal`, and `get_token_tx` simultaneously. You get the full picture—all normal, internal, and token moves—in one response.
Harmonyscan (Harmony One Block Explorer API): The Key is `get_abi`.
When integrating with a contract, you can't just know the address. You need the blueprint. Manually, you'd have to find and interpret the contract's ABI and source code on a separate page. This is tedious and often incomplete.
With this server, your agent runs `get_abi` and `get_source_code`. You get the verified structure and the source code instantly, right where you are working. That’s the difference.
Common Questions About Harmonyscan MCP
How do I check the total supply of ONE using get_one_supply? +
Use get_one_supply to get the total circulating supply of the ONE token. This tool provides the raw, definitive number for the entire network, regardless of current trades.
Which tool should I use to list all token transfers? get_tx_list or get_token_tx? +
Use get_token_tx specifically. get_tx_list shows all types of transactions, but get_token_tx only returns HRC20 token transfers, giving you a cleaner, focused list.
Can I check multiple wallet balances at once using get_balance_multi? +
Yes. get_balance_multi accepts a list of addresses and returns the current ONE balance for every address in that list in a single call.
How do I verify a transaction that might have failed? get_status or get_tx_receipt_status? +
Use get_tx_receipt_status. While get_status gives a quick check, get_tx_receipt_status provides the detailed receipt information, which is necessary to understand why a transaction failed.
What if I need to run a non-standard blockchain query? Use proxy_request? +
The proxy_request tool handles this. It executes any standard JSON-RPC method, letting you call functions not explicitly listed in the server's core tools.
How do I get the contract's source code and ABI using get_source_code and get_abi? +
Use get_source_code and get_abi to retrieve the contract's full source code and Application Binary Interface (ABI). This lets you analyze exactly how the smart contract was written and what functions it exposes.
What type of transactions can I list using get_tx_list and get_tx_list_internal? +
get_tx_list retrieves standard, normal transactions. get_tx_list_internal lists internal transactions, which are critical for understanding complex contract interactions and function calls.
If I need to track a specific token transfer, should I use get_token_tx or proxy_request? +
You should use get_token_tx specifically for listing HRC20 token transfer events. Don't rely on proxy_request for this; it's designed for executing general JSON-RPC methods.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
OneSky (App & Web Localization API)
Automate app and web localization via OneSky — manage project groups, track translation progress, and handle projects directly from your AI agent.
Trigger.dev (Background Tasks & Jobs)
Manage background tasks and jobs via Trigger.dev — trigger tasks, monitor runs, manage schedules, and configure environment variables directly from your AI agent.
SwaggerHub
Connect your AI to SwaggerHub. Read OpenAPI specifications, explore domains, and manage your API design lifecycle natively from the terminal.
You might also like
Chroma (Vector DB)
Manage vector embeddings via Chroma — list collections, query embeddings, and audit document counts directly from any AI agent.
YAML Parser Engine
Convert YAML to JSON and JSON to YAML with absolute precision — including anchors, aliases, and multi-document support. The engine behind Kubernetes, GitHub Actions, and Docker Compose config processing. 30M+ weekly downloads.
Qualified.io
Automate technical hiring and coding assessments — manage assessments, invite candidates, and track test results directly from your AI agent.