How to Use the Axle MCP in Mastra AI

Q: How do I integrate Axle with Mastra AI?

Install @mastra/mcp and initialize the client using your Vinkius endpoint URL. Mastra auto-detects the streamable HTTP transport and loads the logistics tools.

Q: Can Mastra AI retry failed Axle driver updates?

Yes. If updatedriverstatus drops due to a bad connection, the workflow engine automatically retries the tool call using exponential backoff.

Q: Does Axle support human-in-the-loop in Mastra AI?

Yes, it does. You map requireToolApproval to critical write operations like updateload. The workflow pauses until a dispatcher clicks approve.

Q: How do I check system health before running a workflow?

Add getaccountcheck as the first step in your pipeline. The agent verifies the MCP server connection before attempting any complex routing logic.

Build resilient logistics workflows in Mastra AI to manage fleet status and shipment routing.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Axle MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate shipment updates

The `update_load` tool modifies shipment details based on conditional triggers in your Mastra AI workflow. If a delivery gets delayed, the agent automatically adjusts the estimated arrival time and logs the change. Network timeouts happen constantly in freight management. Mastra handles these interruptions by applying exponential backoff to `list_loads` requests until the server responds with the active freight manifest.

Manage duty cycles via MCP

Executing `update_driver_status` requires strict validation to prevent compliance violations during a shift change. You can configure `requireToolApproval` so a human dispatcher signs off before the duty status actually switches. Checking availability first prevents scheduling conflicts. The agent runs `get_driver_availability` to confirm legal driving hours, and branches to an alternative driver if the primary choice lacks the required time.

Track vehicles reliably

Pulling coordinates with `get_vehicle_location` feeds directly into your location monitoring pipeline. The workflow engine evaluates the GPS ping against the expected route and alerts dispatch if the truck deviates. Setup doesn't take much effort. You instantiate the `MCPClient` with your Vinkius URL, call `listTools()`, and spread the resulting fleet tracking operations directly into your agent definition.

Setup guide

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

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

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

Install `@mastra/mcp` and initialize the client using your Vinkius endpoint URL. Mastra auto-detects the streamable HTTP transport and loads the logistics tools.

Yes. If `update_driver_status` drops due to a bad connection, the workflow engine automatically retries the tool call using exponential backoff.

Yes, it does. You map `requireToolApproval` to critical write operations like `update_load`. The workflow pauses until a dispatcher clicks approve.

Add `get_account_check` as the first step in your pipeline. The agent verifies the MCP server connection before attempting any complex routing logic.

Bills of lading and freight manifests remain private. Vinkius executes the MCP server inside a zero-trust V8 isolate, ensuring your Mastra AI workflows pull sensitive shipping documents without exposing credentials.

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