How to Use the LeafLink MCP in Mastra AI

Q: How do I register the LeafLink tools inside Mastra AI?

Initialize the MCPClient with your Vinkius HTTP URL. Call mcpClient.listTools() and spread those tools directly into your Mastra agent configuration.

Build resilient, self-healing cannabis distribution workflows using Mastra AI and the LeafLink MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect LeafLink MCP to Mastra AI

Create your Vinkius account to connect LeafLink 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 LeafLink with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate order lifecycles with Mastra AI

Cannabis distribution demands strict order flows that do not fail. When you register this MCP Server with Mastra AI, your agent can check stock levels using `list_wholesale_products` before updating any shipping states. Write your transition logic directly inside Mastra's workflow engine. If an inventory check fails, the workflow halts automatically, preventing overselling before your agent can trigger `update_order_status`.

Resilient inventory updates with automatic retries

API timeouts shouldn't break your cannabis warehouse synchronization. When updating stock levels via `update_product_inventory`, Mastra's built-in retry engine handles rate limits and network hiccups with exponential backoff. Setup requires running `npm install @mastra/mcp@latest` and instantiating `new MCPClient`. The client handles SSE or HTTP transport automatically to keep your LeafLink inventory data consistent across systems.

Multi-step brand and customer validation

Before creating new wholesale product listings, you need to verify distributor details. Your agent can query `list_wholesale_brands` and `list_wholesale_customers` sequentially to ensure all entities exist before writing new data. Use Mastra's `requireToolApproval` to insert a human-in-the-loop step. This ensures no agent triggers `create_new_product` without explicit sign-off from your compliance officer.

Setup guide

Set up LeafLink 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 LeafLink 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: "leaflink-mcp-client",
  servers: {
    "leaflink-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent LeafLink 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 LeafLink. 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 LeafLink 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 LeafLink MCP in Mastra AI

Initialize the `MCPClient` with your Vinkius HTTP URL. Call `mcpClient.listTools()` and spread those tools directly into your Mastra agent configuration.

Yes. Mastra's workflow engine automatically retries failed calls like `update_product_inventory` using exponential backoff, preventing sync failures during peak wholesale hours.

Yes. You can use Mastra's approval gates to halt the workflow before your agent runs `update_order_status`, requiring a manual click to confirm the wholesale order.

You can deploy your agent to any cloud provider using Mastra's one-command deploy. It connects to the managed Vinkius endpoint securely without complex environment setup.

Yes. All wholesale customer lists and inventory counts are fetched over encrypted HTTPS connections directly to LeafLink's endpoints, with no intermediate data storage in the V8 sandbox.

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