How to Use the SimpleFatoora MCP in Vercel AI SDK

Q: How do I build an e-invoicing flow with SimpleFatoora and Vercel AI SDK?

You use createsimplifiedinvoice to initiate a transaction. The data streams back, allowing you to display the invoice details to the end user as they are being generated live in your front-end application.

Q: Can I list and update SimpleFatoora products using Vercel AI SDK?

Yes. Call listproducts to fetch a full array of product data, then pass that data into your component state. When you call updateproduct, the streaming result confirms the change has been made.

Q: What is the best way to manage SimpleFatoora users in Vercel AI SDK?

You’ll call createcustomer first. This action streams back a confirmation object that you can use to trigger subsequent calls, like fetching details using getcustomer, all within one user interaction.

Build live e-invoicing UIs: Stream SimpleFatoora data directly into your application with Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect SimpleFatoora MCP to Vercel AI SDK

Create your Vinkius account to connect SimpleFatoora to Vercel AI SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup SimpleFatoora with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Generate ZATCA invoices

The `create_vat_invoice` tool lets you build a highly dynamic, real-time user experience. When the client calls this tool, the result streams back instantly, letting users see the invoice details appearing live in their React or Next.js frontends. This process handles complex B2B VAT calculations and ensures every streamed document adheres to ZATCA standards.

Manage customer records

When a user needs to check client information, call `get_customer` via your agent. The data streams immediately into the UI without waiting for a loading spinner, making the app feel fast and responsive. You can also use `list_customers` to populate dropdown menus in real-time when building out forms.

Track product details

Using `get_product`, your client fetches current item pricing data instantly. This is key for any form where the user needs to select items and see their calculated cost. Want to update something? Running `update_product` streams the success confirmation right into the console, giving developers immediate feedback on the API call.

Setup guide

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

You use `create_simplified_invoice` to initiate a transaction. The data streams back, allowing you to display the invoice details to the end user as they are being generated live in your front-end application.

Yes. Call `list_products` to fetch a full array of product data, then pass that data into your component state. When you call `update_product`, the streaming result confirms the change has been made.

The server handles customer and product metadata, plus all transaction documents. This includes `create_debit_note` for returns or adjustments, which you can stream to the user's view.

You’ll call `create_customer` first. This action streams back a confirmation object that you can use to trigger subsequent calls, like fetching details using `get_customer`, all within one user interaction.

This MCP Server touches customer and product metadata. When integrating with your application, the streamed results give you granular control over when and how this business information is displayed.

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