How to Use the 99Minutos Express MCP in Vercel AI SDK

Q: How do I fetch real-time shipping rates with 99Minutos Express and Vercel AI SDK?

Install ai and the @ai-sdk/mcp package, then pass the MCP client tools to streamText. Your agent runs getrates on demand and streams the pricing options directly into your React or Next.js UI components.

Q: Can I cancel a dispatch order using 99Minutos Express and Vercel AI SDK?

Yes. Your agent calls cancelorder to void an active courier run. Because Vercel AI SDK supports edge functions, this happens in milliseconds right when a customer clicks cancel in your application.

Q: How does 99Minutos Express handle geographic coverage checks in Vercel AI SDK?

The agent invokes listcoverage to check if a specific LatAm ZIP code is active. The SDK streams the verification status straight to your checkout form so customers know immediately if same-day delivery is possible.

Stream live last-mile delivery tracking and shipping rates directly into your React app using 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 99Minutos Express MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live LatAm Shipping Estimates in Vercel AI SDK

Let users see delivery costs instantly using `get_rates`. Your app calls the tool through the Vercel AI SDK, feeding raw ZIP codes directly to the 99Minutos API and streaming the price options back to the frontend without a single page reload. This MCP Server lets your agent calculate point-to-point costs and render them live on the screen while the customer is still typing their checkout details. You don't need a separate API route or loading spinner.

Real-Time Courier Map Updates

Stop making customers refresh their browser to find their driver by calling `get_tracking`. By connecting this MCP Server to your Edge Functions, the agent pulls current GPS coordinates of the delivery vehicle. The coordinate data streams straight into your interactive map components. Your users watch their delivery truck move across Mexico City or Santiago in real-time.

Instant Checkout Store Mapping

Let your AI agent find the closest warehouse on the fly with `list_stores`. It queries your physical node network using this MCP Server and registers new dispatch points with `create_store` when you expand to new cities. The entire lookup happens inside the Vercel AI SDK execution context. It keeps your database clean and prevents mismatched shipping origins before the dispatch order is generated.

Setup guide

Set up 99Minutos Express 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 99Minutos Express 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 99Minutos Express 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 99Minutos App. 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 99Minutos Express 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 99Minutos Express MCP in Vercel AI SDK

Install `ai` and the `@ai-sdk/mcp` package, then pass the MCP client tools to `streamText`. Your agent runs `get_rates` on demand and streams the pricing options directly into your React or Next.js UI components.

Yes. Your agent calls `cancel_order` to void an active courier run. Because Vercel AI SDK supports edge functions, this happens in milliseconds right when a customer clicks cancel in your application.

The agent invokes `list_coverage` to check if a specific LatAm ZIP code is active. The SDK streams the verification status straight to your checkout form so customers know immediately if same-day delivery is possible.

Vinkius manages the API keys for 99Minutos. You configure the server once in the Vinkius dashboard and use your single endpoint token when initializing the client in your Next.js project.

Yes. This server only passes delivery addresses, recipient phone numbers, and coordinates to 99Minutos. Vinkius runs the server in an isolated V8 sandbox, ensuring your customers' physical location data is never leaked or stored in plaintext.

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