How to Use the Easyship MCP in Vercel AI SDK

Q: How do I search for Easyship shipments in Vercel AI SDK?

Use the searchshipmentsbyreference tool to query your database by ID. Pass the reference string from your UI input into the tool call within your agent function.

Q: Can Vercel AI SDK handle Easyship rate errors?

Yes, you should wrap the getshippingrates call in a try-catch block. If the API returns an error, your agent can catch it and report the issue to the user through the stream.

Stream real-time logistics data into your Vercel AI SDK frontends with the Easyship 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 Easyship MCP to Vercel AI SDK

Create your Vinkius account to connect Easyship to Vercel AI SDK 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 Easyship with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live shipment tracking in Vercel AI SDK

Feed your UI live tracking data by calling `get_shipment_details` directly from your edge functions. Your users see status updates the moment the agent fetches them from Easyship. Stop waiting for server-side round trips to finish. The Vercel AI SDK streams these responses, so the shipment progress appears instantly in the browser.

Instant rate quoting for Vercel AI SDK

Calculate shipping costs on the fly using `get_shipping_rates` inside your application logic. The agent pulls current courier data to give your customers accurate pricing before they checkout. Filtering is handled by `list_available_couriers` to ensure you only show valid options. You get the data in your stream and render it immediately to the end user.

Audit your logistics volume

Run `quick_shipping_volume_audit` to generate summary reports that visualize your shipping activity. You can push these metrics straight into your dashboard components for a clear view of your operations. Use `list_logistics_shipments` to pull the raw data if you need to build custom tables. Your agent manages the heavy lifting while your frontend remains focused on the user experience.

Setup guide

Set up Easyship MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Easyship tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Easyship transactions",
});

console.log(text);
await mcpClient.close();

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 Easyship. 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 Easyship 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 Easyship MCP in Vercel AI SDK

Use the `search_shipments_by_reference` tool to query your database by ID. Pass the reference string from your UI input into the tool call within your agent function.

Yes, you should wrap the `get_shipping_rates` call in a try-catch block. If the API returns an error, your agent can catch it and report the issue to the user through the stream.

Absolutely, the connection is lightweight and compatible with standard HTTP requests. You won't face issues with cold starts or memory limits while fetching your shipping data.

All communication between your agent and the server is encrypted. You only expose the specific tools needed for your UI, and your actual API keys remain on your secure server.

The server returns details like tracking status, courier names, and delivery dates. This sensitive information stays within your defined agent context and is never logged by the Vinkius infrastructure.

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