How to Use the Alegra MCP in Vercel AI SDK
Build live accounting interfaces with Vercel AI SDK. Stream Colombian tax data straight to your React frontend.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Alegra MCP to Vercel AI SDK
Create your Vinkius account to connect Alegra to Vercel AI SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.
Gemini
Key Capabilities
Stream DIAN invoices directly via MCP Server
Generating compliant electronic invoices usually means staring at loading spinners. You connect this MCP Server to your Vercel AI SDK backend and the experience flips. When your agent calls `create_invoice`, it handles the DIAN validation and stamping in the background. The real advantage happens on the client side. As the invoice data returns, your Next.js frontend renders the line items instantly. Users watch their sales records appear live instead of waiting for a massive JSON payload to finish downloading.
Build live inventory dashboards
Fetching stock levels across multiple warehouses requires constant polling. Hook up `list_warehouses` and `list_items` to your streamText function. Your AI agent pulls exactly what it needs based on the user's prompt. This means you can build a chat interface where a warehouse manager asks about low stock. The agent triggers `get_item` for specific products and the UI updates in real-time. No manual page refreshes required.
Interactive supplier onboarding
Collecting tax ID details for new vendors is a pain. You can route user inputs directly into the `create_contact` tool. The agent automatically categorizes them as clients or suppliers while capturing their NIT or CC numbers. Because you are using Vercel AI SDK, you can wire this up to an Edge function. The moment the contact saves, the confirmation streams back to the user's browser without hitting a cold start delay.
Set up Alegra MCP in Vercel AI SDK
Prerequisites
- Node.js 18+ and a TypeScript project
-
ai+@modelcontextprotocol/sdkpackages - Active Vinkius subscription with a valid endpoint token
- 1
Install dependencies
Run
npm install ai @modelcontextprotocol/sdkplus your preferred model provider (e.g.@ai-sdk/openai). - 2
Create the Streamable HTTP transport
Use
StreamableHTTPClientTransportwith 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 togenerateText()orstreamText()— 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.
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();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.
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
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Alegra MCP today
We host it, we monitor it, we maintain it. You just paste one token.