How to Use the Alchemy MCP in Mastra AI

Q: How can I build a Mastra AI workflow with Alchemy that acts on a specific token balance?

In your workflow, use the gettokenbalances tool. Then, use Mastra's conditional logic to check if the balance of a specific token meets your criteria before running the next step.

Build reliable, multi-step blockchain automations with Alchemy and Mastra AI. Create workflows that react to on-chain events and recover from errors automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Alchemy MCP to Mastra AI

Create your Vinkius account to connect Alchemy 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 Alchemy with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Conditional On-Chain Logic

Mastra AI's workflow engine lets you build 'if-this-then-that' logic using live blockchain data. Use the `get_wallet_balance` tool to check an account. If the balance is below a certain threshold, your workflow can automatically trigger a notification or another process. This isn't just a simple check. You can chain conditions together. For instance: check the balance with `get_wallet_balance`, then check for a specific token with `get_token_balances`, and only proceed if both conditions are met. Mastra handles the state between steps.

Fault-Tolerant Transaction Polling

Stop writing custom retry loops for checking transaction status. A Mastra AI workflow can call `get_transaction_receipt` and, if the transaction isn't confirmed yet, Mastra's engine will automatically retry with exponential backoff. You just define the success condition. This makes your payment verification or asset transfer workflows much more robust. If the Alchemy API has a temporary hiccup, Mastra handles it. Your agent just waits for the final, confirmed receipt without you coding the failure logic.

Automate Audits with a Mastra AI Agent

Set up a scheduled Mastra AI workflow to perform routine wallet audits. The agent can iterate through a list of addresses, calling `get_owned_nfts` and `get_token_balances` for each one. The results can be compiled into a report or sent to another system. This is a hands-off process. You define the workflow once, and Mastra runs it on your schedule. It’s a perfect MCP server for building backend financial bots, compliance checkers, or portfolio trackers that need to be dependable.

Setup guide

Set up Alchemy 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 Alchemy 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: "alchemy-mcp-client",
  servers: {
    "alchemy-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Alchemy 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 Alchemy. 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 Alchemy 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 Alchemy MCP in Mastra AI

In your workflow, use the `get_token_balances` tool. Then, use Mastra's conditional logic to check if the balance of a specific token meets your criteria before running the next step.

Yes, that's a core feature of Mastra AI. Its workflow engine has built-in retry logic with exponential backoff, so you don't need to code polling loops for transaction confirmation.

Absolutely. You can create a Mastra AI workflow that uses the `get_owned_nfts` and `get_token_balances` tools and set it to run on a schedule. It's ideal for automated reporting.

Add a step at the beginning of your workflow that calls the `check_api_status` tool. If it returns anything but operational, you can have the workflow halt or send an alert.

The server handles public blockchain identifiers like wallet addresses and transaction hashes that you provide. Vinkius isolates every MCP server request in a zero-trust environment, and no input data is logged or persisted.

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