How to Use the JSONCargo Maritime MCP in Vercel AI SDK

Q: How do I connect JSONCargo Maritime to my Vercel AI SDK project?

Install @ai-sdk/mcp and call createMCPClient using the HTTP transport. Pass the tools returned by the client directly into streamText to let your agent query vessel locations.

Q: How does JSONCargo Maritime handle API downtime inside the Vercel AI SDK?

You run the checkapistatus tool before calling other maritime tools. If the API is offline, your agent can catch the error and stream a friendly warning message back to the user's UI.

Get real-time shipping data and live vessel logs streaming directly to your Next.js UI using the Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect JSONCargo Maritime MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live vessel tracking in your UI

The `search_maritime_vessels` tool lets your agent find ships by name or IMO number. No more waiting for slow backend responses. The Vercel AI SDK streams this vessel data straight to the user's browser as it resolves. You get immediate rendering of ship names, registry numbers, and current coordinates. It cuts down the perceived latency. Users see search results populating live.

Real-time voyage audits with Vercel AI SDK

The `get_current_voyage_details` tool retrieves active transit logs for any vessel ID in your database. This Vercel AI SDK setup feeds that raw data directly into your streaming UI components so users watch the route details render line by line. Your frontend handles the incoming voyage chunks without freezing the browser. It means cargo coordinators see exact transit milestones and vessel delay metrics appear instantly, bypassing the typical loading spinners.

Instant port congestion updates

The `list_maritime_ports` tool queries port coordinates and active congestion levels across the globe. Coupling this with `check_api_status` ensures your React components only request port data when the JSONCargo service is fully operational. The Vercel AI SDK client handles the connection to the JSONCargo Maritime server, and renders the port data. This keeps your edge functions fast and prevents broken UI states when third-party maritime APIs experience downtime.

Setup guide

Set up JSONCargo Maritime 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 JSONCargo Maritime 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 JSONCargo Maritime 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 JSONCargo. 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 JSONCargo Maritime 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 JSONCargo Maritime MCP in Vercel AI SDK

Install `@ai-sdk/mcp` and call `createMCPClient` using the HTTP transport. Pass the tools returned by the client directly into `streamText` to let your agent query vessel locations.

Yes, the Vercel AI SDK runs on the Edge, and this MCP server connects over a lightweight HTTP transport. You can query `list_maritime_ports` inside your Edge routing without hitting cold starts.

You run the `check_api_status` tool before calling other maritime tools. If the API is offline, your agent can catch the error and stream a friendly warning message back to the user's UI.

Yes, the SDK streams the tool execution steps directly to your Next.js or React frontend. Users see the raw voyage details and vessel coordinates as they arrive from the JSONCargo Maritime MCP server.

This MCP server does not store your queried IMO numbers or port congestion logs. Every request runs in an isolated, ephemeral V8 sandbox on Vinkius, ensuring your operational maritime data remains private.

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