How to Use the Deterministic Fair-Share Tip Splitter MCP in Vercel AI SDK

Q: Does this tool handle shared items like appetizers or a bottle of wine?

Yes. When you build the JSON array of items for the splitbill tool, you can define an item that was shared and list all the people who partook. The tool will divide the cost of that specific item evenly among just those people.

Stream exact bill splits directly into your Next.js app with the Vercel AI SDK. No more loading spinners for your users.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Deterministic Fair-Share Tip Splitter MCP to Vercel AI SDK

Create your Vinkius account to connect Deterministic Fair-Share Tip Splitter 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 Deterministic Fair-Share Tip Splitter with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Split Bills with Live UI Updates

The `split_bill` tool calculates each person's share of a restaurant bill down to the penny. You just pass it a JSON array of items, the total tax, and the tip percentage. With the Vercel AI SDK, the results stream back instantly. Your users can watch their exact share update in real-time right in your app's UI. It's a much better experience than making them wait for a final number.

Proportional Tax and Tip Distribution

This tool doesn't just split the total—it correctly assigns tax and tip based on what each person actually ordered. Someone's $50 steak gets a proportionally larger share of the bill than a $15 salad. It's fair. Your frontend can then display a clear breakdown for everyone. It shows their items, their part of the tax, their tip, and the final amount. This ends the 'who owes what' argument for good.

Deterministic Math from an MCP Server

The math here is deterministic. Every time you run `split_bill` with the same inputs, you get the exact same output. It even handles leftover pennies by assigning them to the person with the highest subtotal, so the final numbers always add up perfectly to the receipt total. Because Vinkius manages this MCP Server, you don't have to worry about hosting or scaling. You just connect your Vercel app, and your AI client gets a reliable MCP tool for financial calculations.

Setup guide

Set up Deterministic Fair-Share Tip Splitter 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 Deterministic Fair-Share Tip Splitter 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 Deterministic Fair-Share Tip Splitter 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 tip-splitter. 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 Deterministic Fair-Share Tip Splitter 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 Deterministic Fair-Share Tip Splitter MCP in Vercel AI SDK

You connect your Vercel AI SDK client to the MCP endpoint token provided by Vinkius. Then, you pass the `split_bill` tool to the `generateText` or `streamText` function. That's it.

Yes. When you build the JSON array of items for the `split_bill` tool, you can define an item that was shared and list all the people who partook. The tool will divide the cost of that specific item evenly among just those people.

It provides instant, accurate results and handles the tricky edge cases that humans mess up, like proportional tipping and penny rounding. It makes your app's financial feature trustworthy.

This MCP tool prevents them. It uses a largest-remainder method to deterministically assign any leftover fractional pennies after the proportional split. The final sum will always match the receipt total exactly.

The server only processes the data you send for the calculation: a stringified JSON array of items, the taxAmount, and the tipPercentage. This data is handled in an ephemeral Vinkius sandbox and is not stored or logged after the response is sent.

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