How to Use the Alchemy MCP in Vercel AI SDK

Q: How do I use Alchemy with the Vercel AI SDK to display an NFT gallery?

Have your agent call the getownednfts tool with a wallet address. The Vercel AI SDK will stream the list of NFTs, so you can render them in your UI as they arrive instead of waiting for the full list.

Q: What's the fastest way to check a wallet balance with Alchemy and the Vercel AI SDK?

Use the getwalletbalance tool for the native ETH balance and gettokenbalances for ERC-20s. Because the AI SDK streams the tool output, your UI can show the balance instantly without waiting for a full page reload.

Q: Can I build a live transaction status page with Alchemy and the Vercel AI SDK?

Yes. Pass a transaction hash to the gettransactionreceipt tool. You can stream the receipt data directly into your React or Svelte components to show users live confirmation details.

Q: Does this MCP server let me watch the Ethereum network?

It gives you two key metrics. You can use getlatestblocknumber to see the most recent block, confirming the chain is active. You can also use checkapistatus to make sure the Alchemy service itself is online.

Stream live Alchemy data right into your Vercel AI SDK app. Build frontends that show wallet balances and NFT collections without a loading spinner.

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 Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build a Live Wallet Dashboard

Stop making users wait. Use the Vercel AI SDK to stream wallet data directly into your React or Next.js components. Your agent can call `get_wallet_balance`, `get_token_balances`, and `get_owned_nfts`, and the results appear in your UI as they arrive. This isn't just a data dump. Because the results stream, you can design a UI that populates the ETH balance first, then fills in ERC-20 tokens, and finally loads NFT images one by one. It feels fast and responsive because it is.

Real-Time Transaction Receipts

Give users immediate feedback on their transactions. When your agent calls `get_transaction_receipt` with a hash, the Vercel AI SDK streams the details directly to the client. You can show the confirmation status, gas used, and block number the moment it's available on-chain. This is perfect for post-purchase pages or activity feeds. Instead of a generic 'pending' message, you can show the actual receipt data as it's confirmed. It builds trust and gives users the details they're looking for.

Your MCP Server, Your Status

Build a simple status component for your app's footer or a dedicated status page. Your agent can periodically call `check_api_status` to confirm the Alchemy service is up and `get_latest_block_number` to show that the chain is progressing. Since the AI SDK is edge-compatible, you can run these checks without bogging down your main application. It’s a lightweight way to give your users (and yourself) peace of mind that everything is working as expected.

Setup guide

Set up Alchemy MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Alchemy tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Alchemy transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Have your agent call the `get_owned_nfts` tool with a wallet address. The Vercel AI SDK will stream the list of NFTs, so you can render them in your UI as they arrive instead of waiting for the full list.

Use the `get_wallet_balance` tool for the native ETH balance and `get_token_balances` for ERC-20s. Because the AI SDK streams the tool output, your UI can show the balance instantly without waiting for a full page reload.

Yes. Pass a transaction hash to the `get_transaction_receipt` tool. You can stream the receipt data directly into your React or Svelte components to show users live confirmation details.

It gives you two key metrics. You can use `get_latest_block_number` to see the most recent block, confirming the chain is active. You can also use `check_api_status` to make sure the Alchemy service itself is online.

The server only processes the data needed for a specific tool, like a wallet address for `get_owned_nfts` or a transaction hash for `get_transaction_receipt`. Vinkius runs each MCP server in an ephemeral sandbox, so your request data isn't stored after the job is done.

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