How to Use the Alegra MCP in Vercel AI SDK

Q: How do I stream Alegra billing data using the Vercel AI SDK?

Install the @ai-sdk/mcp package and connect it to your Alegra endpoint. Pass the tools directly into streamText so your LLM can call listinvoices and display the live JSON stream directly in your React components.

Q: What happens if an invoice creation fails during a live chat?

The Vercel AI SDK catches the error from createinvoice and streams the failure state to the user. You can handle this gracefully by prompting the user to correct their input details.

Build LatAm invoicing interfaces that stream real-time Alegra data directly into your Vercel AI SDK frontend.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Alegra MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Real-time Alegra invoice rendering with Vercel AI SDK

Feed live billing data directly into your frontend by calling `list_invoices` through your streaming interface. This MCP Server streams live financial data straight to your React or Next.js frontend, letting your client render active billing docs instantly. When a user requests their billing history, the server feeds the raw JSON directly into your UI components before the LLM even finishes its sentence. It lets your users instantly view or search their records without waiting for API roundtrips to finish. You can let customers pull up specific billing details by calling `get_invoice_details` directly inside their chat window, creating a native-feeling dashboard that feels like a local app instead of a slow API integration.

Live inventory lookups in your chat interface

Run `list_inventory_items` to fetch live stock levels on the fly during active customer chats. By hooking your edge functions to this MCP toolset, your UI updates the stock levels live as the agent talks. The agent pulls the current product catalog and displays pricing cards directly in the stream. You don't need to write custom backend endpoints for every inventory query. Just let the SDK handle the streaming tools like `get_item_details` to show specifications, images, and tax details to the customer right when they ask for them.

Instant contact onboarding on the edge

Trigger `create_contact` to onboard new LatAm vendors or clients directly from a simple input field without reloading the page. Your agent takes the raw text input from the user, structures it, and fires off the API call to Alegra. The frontend displays the newly created profile data in real-time as the SDK streams the confirmation. This setup runs entirely on edge functions to keep latency low. The MCP Server handles the heavy lifting, allowing the agent to run `list_contacts` to search your database and prevent duplicate entries before creating a new profile.

Setup guide

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

Install the `@ai-sdk/mcp` package and connect it to your Alegra endpoint. Pass the tools directly into `streamText` so your LLM can call `list_invoices` and display the live JSON stream directly in your React components.

Yes, the setup is fully compatible with Vercel's edge runtime. You can trigger Alegra's `get_company_info` or `create_invoice` on the edge without running into cold-start slowdowns.

Use the MCP client's built-in support for passing secure headers to Alegra. This ensures each customer only accesses their own invoices when calling `get_invoice_details` or `list_payments`.

The Vercel AI SDK catches the error from `create_invoice` and streams the failure state to the user. You can handle this gracefully by prompting the user to correct their input details.

All Alegra financial transactions, tax documents, and invoice details are isolated within the Vinkius MCP sandbox. Your credentials never touch the LLM provider directly, keeping your LatAm tax records encrypted and secure.

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