How to Use the GoBolt MCP in Mastra AI

Q: How do I add GoBolt MCP Server tools to a Mastra AI agent?

Instantiate the MCPClient with your Vinkius URL and register it inside your Mastra configuration. You can then spread the tools directly into your agent's tool array.

Q: How does Mastra AI verify GoBolt API credentials?

The workflow calls verifyapiconnection during initialization to confirm your merchant keys are valid. This prevents runtime failures before your system starts processing actual orders.

Automate complex multi-step shipping workflows and self-healing logistics pipelines using Mastra AI and GoBolt.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GoBolt MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Self-healing logistics with Mastra AI workflows

Shipping operations get messy when carrier rates fluctuate or APIs drop. By connecting Mastra AI to this MCP Server, you can build resilient workflows that automatically retry failed requests. The agent uses `verify_api_connection` to check the carrier network before attempting to book any shipments. If a carrier fails, Mastra's built-in workflow engine catches the error and redirects the order. It immediately executes `find_cheapest_rate` to secure an alternative carrier, keeping your warehouse moving without human intervention.

Automated order modifications on hold

Customers change their minds about delivery addresses all the time. Mastra AI can monitor incoming support tickets, match them with active shipments, and run `modify_shipping_order` via the MCP Server. After making the change, the agent calls `get_order_details` to verify the update took effect. If the package has already shipped, the workflow branches to alert your support team instead of failing silently.

Dynamic rate optimization workflows

Stop manually comparing shipping tables to save pennies on high-volume runs. Your Mastra AI agent can automate this by calling `get_shipping_rates` for every incoming order. The workflow applies your custom business logic to balance speed and cost. It chooses between `find_fastest_rate` for premium buyers and `find_cheapest_rate` for standard orders, then triggers `create_shipping_order` to lock in the label.

Setup guide

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

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

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

Instantiate the `MCPClient` with your Vinkius URL and register it inside your Mastra configuration. You can then spread the tools directly into your agent's tool array.

Yes, Mastra's workflow engine uses automatic retries with exponential backoff. If `create_shipping_order` fails, the agent retries or switches carriers automatically.

The workflow calls `verify_api_connection` during initialization to confirm your merchant keys are valid. This prevents runtime failures before your system starts processing actual orders.

Yes, Mastra supports human-in-the-loop approvals. You can pause the workflow after calling `get_order_details` and wait for an admin sign-off before running `modify_shipping_order`.

Your merchant keys, API tokens, and order IDs are stored securely as environment variables. The MCP Server acts as an ephemeral proxy, passing these credentials directly to the carrier without saving them.

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