AfterShip MCP Server for Mastra AI 9 tools — connect in under 2 minutes
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect AfterShip 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
Vinkius supports streamable HTTP and SSE.
import { 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: {
"aftership": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "AfterShip Agent",
instructions:
"You help users interact with AfterShip " +
"using 9 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with AfterShip?"
);
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 AfterShip MCP Server
Connect AfterShip tracking platform to any AI agent and track packages from 1,000+ couriers worldwide, auto-detect shipping companies, and manage all your shipments through natural language.
Mastra's agent abstraction provides a clean separation between LLM logic and AfterShip tool infrastructure. Connect 9 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
- Package Tracking — Create and monitor shipments from FedEx, UPS, DHL, USPS, and 1,000+ other couriers
- Auto-Detect Courier — Automatically identify the shipping company from just a tracking number
- Tracking History — View complete delivery history with checkpoint timestamps and locations
- Delivery Management — Mark trackings as completed, retrack expired ones, or delete old entries
- Customer Notifications — Set up email and SMS notifications for delivery updates
- Courier Directory — Browse all supported courier companies with their contact info and requirements
The AfterShip MCP Server exposes 9 tools through the Vinkius. Connect it to Mastra AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect AfterShip to Mastra AI via MCP
Follow these steps to integrate the AfterShip MCP Server with Mastra AI.
Install dependencies
Run npm install @mastra/core @mastra/mcp @ai-sdk/openai
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token
Run the agent
Save to agent.ts and run with npx tsx agent.ts
Explore tools
Mastra discovers 9 tools from AfterShip via MCP
Why Use Mastra AI with the AfterShip MCP Server
Mastra AI provides unique advantages when paired with AfterShip through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add AfterShip 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 AfterShip 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
AfterShip + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the AfterShip MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query AfterShip, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed AfterShip as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query AfterShip on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using AfterShip tools alongside other MCP servers
AfterShip MCP Tools for Mastra AI (9)
These 9 tools become available when you connect AfterShip to Mastra AI via MCP:
create_tracking
Requires at least the tracking number. Optionally specify the courier slug, title, customer emails, SMS phone numbers, order ID, and custom fields. Create a new package tracking
delete_tracking
This action cannot be undone. Delete a tracking entry
detect_courier
Useful when the user provides a tracking number but doesn't know which courier it belongs to. Returns a ranked list of likely couriers. Auto-detect courier from tracking number
get_tracking
Get details of a specific tracking
list_couriers
) that can be used for tracking packages. List all supported courier companies
list_trackings
Supports extensive filtering by courier (slug), tag, keyword, origin, destination, date ranges, and delivery status. List all package trackings
mark_tracking_completed
Useful when the package has been delivered but the courier hasn't updated the final status. Mark a tracking as completed
retrack_tracking
This restarts monitoring and will fetch new checkpoint updates. Retrack an expired tracking
update_tracking
Does not affect the tracking number or courier. Update an existing tracking
Example Prompts for AfterShip in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with AfterShip immediately.
"Track my package with tracking number 1Z999AA10123456784."
"What courier handles tracking number 9400111899223344556677?"
"Show me all my active trackings."
Troubleshooting AfterShip MCP Server with Mastra AI
Common issues when connecting AfterShip to Mastra AI through the Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpAfterShip + Mastra AI FAQ
Common questions about integrating AfterShip 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?
Connect AfterShip with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect AfterShip to Mastra AI
Get your token, paste the configuration, and start using 9 tools in under 2 minutes. No API key management needed.