How to Use the 99Minutos Express MCP in Mastra AI

Q: How do I connect the 99Minutos Express MCP Server to a Mastra AI workflow?

Install @mastra/mcp and instantiate the client pointing to your Vinkius HTTP URL. Then, call listTools on the client and spread those tools directly into your Mastra agent definition.

Q: Can Mastra AI handle human approval before booking a 99Minutos Express courier?

Yes. Use Mastra's requireToolApproval configuration on the agent. When the agent wants to call createorder, the workflow pauses and waits for an operator to approve the courier cost.

Q: How do I track active shipments using 99Minutos Express and Mastra AI?

The agent executes listorders to fetch active runs. It can then loop through them and call gettracking to pull real-time GPS coordinates, updating your database with the vehicle's exact progress.

Build resilient, self-healing LatAm delivery workflows with Mastra AI and this 99Minutos Express integration.

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 Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Delivery Retries with Mastra AI Workflows

Courier dispatches fail for stupid reasons, but your agent handles them by running `create_order`. With this MCP Server, you can write a Mastra workflow that executes the order and automatically retries with exponential backoff if the API throws a transient error. You can even set up conditional logic. If a dispatch fails three times, the workflow triggers `get_rates` to check alternative shipping speeds before notifying your operations team.

Autonomous Reverse Logistics Pipelines

Managing returns is a massive headache, so this MCP Server lets your agent monitor them with `list_return_orders`. The agent watches which customers are sending items back and logs the statuses directly in your workflow. Once a return is flagged, the agent programmatically calls `create_order` to schedule a courier pickup at the customer's home. The workflow handles the scheduling without human intervention.

Event-Driven Dispatch Webhooks

Stop polling for delivery status and inject an HTTP delivery ping receptor using `create_webhook`. You can monitor your active webhooks with `list_webhooks` to ensure your event pipeline stays healthy. When the MCP Server catches the event, your Mastra workflow catches the event and updates your internal system instantly. You get clean, async event architecture with zero cron jobs.

Setup guide

Set up 99Minutos Express MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All 99Minutos Express tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "99minutos-express-mcp-client",
  servers: {
    "99minutos-express-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "99Minutos Express Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to 99Minutos Express tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent 99Minutos Express transactions"
);
console.log(result.text);

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 Mastra AI

Install `@mastra/mcp` and instantiate the client pointing to your Vinkius HTTP URL. Then, call `listTools` on the client and spread those tools directly into your Mastra agent definition.

Yes. Use Mastra's `requireToolApproval` configuration on the agent. When the agent wants to call `create_order`, the workflow pauses and waits for an operator to approve the courier cost.

The agent executes `list_orders` to fetch active runs. It can then loop through them and call `get_tracking` to pull real-time GPS coordinates, updating your database with the vehicle's exact progress.

Your workflow can update your shipping nodes dynamically. The agent uses `create_store` to register a new warehouse location or `list_stores` to check which physical nodes are already saved.

This integration processes LatAm shipping addresses, recipient names, and phone numbers. Vinkius secures this data by routing all API requests through ephemeral, zero-trust sandboxes so your customer data never touches persistent logs.

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