How to Use the Alipay Open Platform MCP in Vercel AI SDK

Q: How do I handle Alipay Open Platform refunds inside a Vercel AI SDK app?

Call the refundtrade tool directly from your agent's tool-calling block. The Vercel AI SDK streams the refund payload back to your UI, letting you show the refund confirmation to the customer in real-time.

Q: How do I clean up the connection after running Alipay Open Platform tasks in Vercel AI SDK?

You must call mcpClient.close() once your stream completes. This prevents hanging HTTP connections and ensures your serverless functions spin down cleanly without leaking resources.

Q: What tools are available for checking transaction status?

You can use querytrade for general orders and querytransfer for direct fund transfers. Both tools return raw status payloads that your model parses and displays to the user.

Get real-time Alipay transaction updates streaming straight into your Next.js frontend with Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Alipay Open Platform MCP to Vercel AI SDK

Create your Vinkius account to connect Alipay Open Platform 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 Alipay Open Platform with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream live Alipay transactions to your AI SDK frontend

The `create_trade` tool lets your AI client spin up new Alipay orders and stream the payment status directly into your user interface. Instead of making your users stare at a loading spinner, this MCP server pushes raw trade data straight to Vercel AI SDK's streaming UI components as it happens. When a payment completes, you can immediately trigger `query_trade` to update the DOM. Because this runs on edge-compatible infrastructure, your frontend stays lightweight and responsive while handling heavy-duty financial transactions.

Instant refunds and cancellations on the edge

The `refund_trade` tool handles immediate financial rollbacks when a customer requests a cancellation in your chat interface. Your user-facing agent initiates the refund, gets the status, and updates the customer's viewport without reloading the page. If a trade is pending and needs to be killed, the `close_trade` tool shuts down the unpaid order instantly. The Vercel AI SDK handles the asynchronous state transitions, showing the user the exact moment their cart clears.

Pull authenticated user profiles in real-time

The `get_oauth_token` tool exchanges authorization codes for secure user tokens using this MCP server. Once authorized, the agent invokes `query_user_info` to fetch and display the customer's Alipay profile details. This setup lets you build onboarding flows where the user grants permissions inside the chat. The SDK maps the incoming JSON payload to your UI state, creating a login experience that feels completely native.

Setup guide

Set up Alipay Open Platform 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 Alipay Open Platform 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 Alipay Open Platform 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 Alipay. 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 Alipay Open Platform 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 Alipay Open Platform MCP in Vercel AI SDK

Call the `refund_trade` tool directly from your agent's tool-calling block. The Vercel AI SDK streams the refund payload back to your UI, letting you show the refund confirmation to the customer in real-time.

Yes, the MCP client runs perfectly in Edge runtimes. You initialize the connection using `createMCPClient` with an HTTP transport, then pass the tools to `streamText` for fast, low-latency execution.

You must call `mcpClient.close()` once your stream completes. This prevents hanging HTTP connections and ensures your serverless functions spin down cleanly without leaking resources.

You can use `query_trade` for general orders and `query_transfer` for direct fund transfers. Both tools return raw status payloads that your model parses and displays to the user.

All Alipay API keys and OAuth tokens are isolated in Vinkius's secure V8 sandbox. Your frontend code only interacts with the single, authenticated MCP endpoint, keeping your private merchant certificates completely hidden from the client side.

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