How to Use the Harmonyscan (Harmony One Block Explorer API) MCP in Mastra AI

Q: Can I use Harmonyscan (Harmony One Block Explorer API) to verify contract deployments in Mastra AI?

Yes, you can build a workflow step that calls getsourcecode to verify the deployment status. If the contract is verified, the agent proceeds; otherwise, it can halt the pipeline.

Q: Is it possible to trigger conditional branching based on token transfers using Harmonyscan (Harmony One Block Explorer API) in Mastra AI?

Yes, your workflow can parse the output of gettokentx to check for specific transfer amounts. Based on the returned value, the agent branches to execute different operational steps.

Q: Can I use standard JSON-RPC calls within my agent workflows?

Yes, the proxyrequest tool allows you to execute raw JSON-RPC methods directly through the explorer interface. This gives your agent access to low-level node queries when standard tools do not cover your specific use case.

Build reliable, self-healing Harmony One workflows with Mastra AI and the Harmonyscan MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Harmonyscan (Harmony One Block Explorer API) MCP to Mastra AI

Create your Vinkius account to connect Harmonyscan (Harmony One Block Explorer API) to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Harmonyscan (Harmony One Block Explorer API) with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Failed Transaction Retries with Mastra AI

Blockchain transactions fail for many reasons, from gas spikes to network congestion. When your workflow detects a failure, Mastra AI triggers a retry loop that checks `get_tx_receipt_status` at exponential intervals. By combining this logic with `get_status`, your agent makes smart decisions about whether to resubmit the transaction or notify an administrator. You define the flow once, and the engine handles execution.

Verify Balances via MCP Server

Verify funds across multiple shards before executing complex smart contract calls with this MCP server. Your agent uses `get_balance_multi` to aggregate balances from several target addresses simultaneously. If the total balance falls below your threshold, the workflow branches automatically to pause operations. This prevents wasted gas fees on transactions destined to fail due to insufficient funds.

Trigger Workflows on Smart Contract Events

Monitor contract behavior autonomously without paying for expensive indexing services. The workflow engine queries `get_logs` to scan for specific events emitted by your deployed contracts. Once a matching log is found, the agent pulls the corresponding ABI using `get_abi` to decode the payload. This lets your system react to on-chain events by triggering webhooks or running local scripts.

Setup guide

Set up Harmonyscan (Harmony One Block Explorer API) MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Harmonyscan (Harmony One Block Explorer API) tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "harmonyscan-harmony-one-block-explorer-api-mcp-client",
  servers: {
    "harmonyscan-harmony-one-block-explorer-api-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Harmonyscan (Harmony One Block Explorer API) Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Harmonyscan (Harmony One Block Explorer API) tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Harmonyscan (Harmony One Block Explorer API) transactions"
);
console.log(result.text);

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Harmonyscan (Harmony One Block Explorer API) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Harmonyscan (Harmony One Block Explorer API) MCP in Mastra AI

The framework features built-in retry mechanisms with backoff. If the explorer API returns a rate-limit error during a `get_tx_list` call, the agent pauses and retries automatically without crashing your workflow.

Yes, you can build a workflow step that calls `get_source_code` to verify the deployment status. If the contract is verified, the agent proceeds; otherwise, it can halt the pipeline.

Yes, your workflow can parse the output of `get_token_tx` to check for specific transfer amounts. Based on the returned value, the agent branches to execute different operational steps.

Yes, the `proxy_request` tool allows you to execute raw JSON-RPC methods directly through the explorer interface. This gives your agent access to low-level node queries when standard tools do not cover your specific use case.

No. All queries for contract ABIs and transaction histories run within an isolated, zero-trust container. Your API keys are encrypted at rest, and no proprietary contract source code is ever cached or shared.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript