ShipBob MCP Server for Mastra AIGive Mastra AI instant access to 30 tools to Batch Cancel Shipments, Batch Update Tracking, Cancel Order, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect ShipBob through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The ShipBob MCP Server for Mastra AI is a standout in the Ecommerce category — giving your AI agent 30 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"shipbob": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "ShipBob Agent",
instructions:
"You help users interact with ShipBob " +
"using 30 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with ShipBob?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About ShipBob MCP Server
Connect your ShipBob account to any AI agent and take full control of your e-commerce fulfillment and supply chain through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and ShipBob tool infrastructure. Connect 30 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Order Management — List, retrieve, and create fulfillment orders. Check real-time statuses and cancel orders when necessary.
- Product Catalog — Manage your virtual product records, list variants, and convert items into bundles directly from the chat.
- Inventory Tracking — Monitor inventory levels across different locations, check lot-specific data, and query historical inventory movements.
- Shipment Visibility — Get detailed tracking information and update shipment addresses to ensure successful deliveries.
- Returns & Receiving — Create and manage return orders and Warehouse Receiving Orders (WRO) to keep your supply chain moving.
The ShipBob MCP Server exposes 30 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 30 ShipBob tools available for Mastra AI
When Mastra AI connects to ShipBob through Vinkius, your AI agent gets direct access to every tool listed below — spanning fulfillment, order-tracking, supply-chain, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Batch cancel shipments on ShipBob
Cancel multiple shipments at once
Batch update tracking on ShipBob
Mark tracking as synced to your system
Cancel order on ShipBob
Cancel an order and its shipments
Convert variant to bundle on ShipBob
Convert a variant into a bundle
Create order on ShipBob
Create a new fulfillment order
Create product on ShipBob
Create a new product with variants
Create receiving on ShipBob
Create a new Warehouse Receiving Order (WRO)
Create return on ShipBob
Create a return order (RMA)
Get inventory levels on ShipBob
Get aggregated inventory levels across all locations
Get inventory levels by location on ShipBob
Get inventory levels grouped by fulfillment center
Get inventory levels by lot on ShipBob
Get inventory levels grouped by lot/expiration
Get order on ShipBob
Get order details and shipment status
Get product on ShipBob
Get details for a specific product
Get receiving labels on ShipBob
Get PDF box labels for a WRO
Get shipment on ShipBob
Get specific shipment details
List channels on ShipBob
g., a Shopify store). List all channels the user has access to
List inventory on ShipBob
List all inventory items
List invoices on ShipBob
List invoices by date range
List orders on ShipBob
List orders with status/tracking filters
List product variants on ShipBob
List all variants for a product
List products on ShipBob
List products with filtering
List receiving on ShipBob
List Warehouse Receiving Orders (WROs)
List returns on ShipBob
List return orders
List transaction fees on ShipBob
List available fee types
Query inventory history on ShipBob
Query inventory movement events
Query transactions on ShipBob
Search transactions (charges, credits)
Set external sync receiving on ShipBob
Mark WROs as synced to your system
Update product on ShipBob
Update product details
Update return on ShipBob
Update an existing return
Update shipment address on ShipBob
Update the shipping address for a shipment
Connect ShipBob to Mastra AI via MCP
Follow these steps to wire ShipBob into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the ShipBob MCP Server
Mastra AI provides unique advantages when paired with ShipBob through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add ShipBob without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every ShipBob tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
ShipBob + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the ShipBob MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query ShipBob, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed ShipBob as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query ShipBob on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using ShipBob tools alongside other MCP servers
Example Prompts for ShipBob in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with ShipBob immediately.
"List all my active ShipBob sales channels."
"What is the current status and tracking for order 123456?"
"Show me the inventory levels for SKU 'SUMMER-HAT-01'."
Troubleshooting ShipBob MCP Server with Mastra AI
Common issues when connecting ShipBob to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpShipBob + Mastra AI FAQ
Common questions about integrating ShipBob MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Recharge
11 toolsAutomate subscription commerce via Recharge — manage subscriptions, customers, and orders directly from any AI agent.
Flexport
12 toolsManage global freight shipments, purchase orders, and logistics documents via AI agents with Flexport.
Basecamp
7 toolsManage your Basecamp projects via AI — list tasks, read message boards, track campfire logs, and orchestrate to-dos seamlessly.
Bidsketch
10 toolsAutomate proposal creation via Bidsketch — list proposals, clients, and templates directly from any AI agent.