How to Use the Xero MCP in Vercel AI SDK

Q: How do I use Xero data with the Vercel AI SDK?

You call your agent using the mcpClient.tools() method, passing it the list of available tools from the MCP Server. The client then handles streaming the results directly to your React component.

Q: Is handling Xero invoices easy with Vercel AI SDK?

Yeah, it’s straightforward. The getinvoicedetails tool lets you pull comprehensive invoice data. Since the Vercel AI SDK supports streaming, your front end displays that detail right away, making the user experience feel fast.

Q: What kind of payments can I track with Xero and Vercel AI SDK?

You can list all payments applied to invoices using listxeropayments. The MCP Server handles this data pull, which you then stream into your app for real-time visibility.

Stream real-time Xero financial data into your React 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 Xero MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Get Balance Sheet Data Live

The `get_balance_sheet` tool fetches assets, liabilities, and equity totals for a date you specify. When you call this via the Vercel AI SDK, the data appears in your UI immediately; there's no waiting spinner. This real-time streaming capability lets users see exactly what numbers they need—like checking current company equity—as the agent processes it.

Review Invoice Details On Demand

Use `get_invoice_details` to pull up complete information for a specific Xero invoice. Because of the Vercel AI SDK's streaming output, your frontend can display these details in pieces as they arrive. It’s perfect for building an app where users need to review granular data points—like payment terms or line-item totals—and see them populate instantly.

List All Bank Transactions Quickly

The `list_bank_transactions` tool pulls every transaction recorded in the Xero bank accounts. Streaming this list through the Vercel AI SDK ensures that even if there are thousands of entries, your user sees them appearing sequentially. This speed is key for building financial dashboards; instead of hitting a loading wall, users get instant feedback on their cash flow history.

Setup guide

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

You call your agent using the `mcpClient.tools()` method, passing it the list of available tools from the MCP Server. The client then handles streaming the results directly to your React component.

You can access several financial reports and lists, including balance sheets (`get_balance_sheet`), profit & loss statements (`get_profit_and_loss`), and bank transactions. All of this is available through the MCP Server.

Yeah, it’s straightforward. The `get_invoice_details` tool lets you pull comprehensive invoice data. Since the Vercel AI SDK supports streaming, your front end displays that detail right away, making the user experience feel fast.

You can list all payments applied to invoices using `list_xero_payments`. The MCP Server handles this data pull, which you then stream into your app for real-time visibility.

This server touches detailed financial records. Specifically, it manages assets and liabilities when calling `get_balance_sheet`.

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