How to Use the SafeCube Container Tracking MCP in Vercel AI SDK

Stream real-time maritime logistics data into your React or Next.js UI using the Vercel AI SDK and SafeCube Container Tracking.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect SafeCube Container Tracking MCP to Vercel AI SDK

Create your Vinkius account to connect SafeCube Container Tracking to Vercel AI SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup SafeCube Container Tracking with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Live container status updates

Feed live shipping data directly into your front-end components. Your AI client calls `get_container_tracking` to pull location data that updates your UI without a single loading spinner. This keeps your users informed with accurate ETAs. You avoid stale data by rendering tool output immediately as the stream arrives.

Shipment audit with Vercel AI SDK

Expose `get_shipment_events` to your interface to display the full history of a container. Your users get a clear view of every port call and transit delay. This tool turns complex logistics logs into readable event streams. You build a dashboard that reflects the actual physical status of the cargo.

Operational health monitoring

Use `check_api_status` to prevent runtime errors before they happen. Your app verifies the connection to the cargo servers before the user triggers a request. This adds a layer of reliability to your shipping tools. You catch downtime early and provide better feedback when the back-end is unreachable.

Setup guide

Set up SafeCube Container Tracking 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 SafeCube Container Tracking 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 SafeCube Container Tracking 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 SafeCube. 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 SafeCube Container Tracking 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 SafeCube Container Tracking MCP in Vercel AI SDK

Install the MCP packages and define the transport layer using your endpoint. You then pass the tools directly into your `generateText` function to allow your AI to call them.

Yes. Since the SDK is built for streams, the tool results flow to your UI as they arrive. This is ideal for showing long lists of shipment events as they load.

Yes, the connection is lightweight and works within the constraints of edge runtimes. You just need to handle the network request to the server correctly.

You provide an auth token to the client configuration. The server handles the handshake so your front-end logic remains clean.

It provides container location, event logs, and status checks. This is raw maritime logistics data, not PII, kept secure behind your connection token.

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