How to Use the SafeCube Container Tracking MCP in Windsurf

Q: How do I add the SafeCube Container Tracking MCP Server to my Windsurf setup?

Open your mcpconfig.json file in Windsurf or go to Settings and find the MCP Servers UI. Paste the Vinkius-provided connection URL under the mcpServers key and click refresh. Cascade instantly discovers the four tracking tools and makes them available for your next prompt.

Q: How do I check if the tracking API is down using Windsurf?

You run the checkapistatus tool. If Cascade encounters connection issues while pulling container histories, it calls this endpoint to determine if the issue lies with the SafeCube servers or your local network.

Let Windsurf autonomously chain container tracking calls and surface real-time maritime shipment events without manual polling.

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 Windsurf

Create your Vinkius account to connect SafeCube Container Tracking to Windsurf — 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Automate ocean cargo monitoring in Windsurf

The `list_active_shipments` tool pulls every active ocean container registered in your SafeCube account directly into your Cascade panel. Cascade reads this list, recognizes which shipments need attention, and plans the next steps without waiting for your input. Instead of jumping between browser tabs, you let your IDE build a live tracking view. Cascade runs the initial list, identifies delayed shipments, and presents the filtered results in a clean markdown table.

Trace container journeys with Cascade

The `get_container_tracking` tool feeds GPS coordinates and status updates for any container ID straight into your Windsurf workspace. Cascade uses this raw data to map out the physical journey of your cargo, noting any deviation from the planned route. Your agent handles the heavy lifting of parsing ISO 6346 container formats. It correlates the tracking data against your local database to flag discrepancies in expected arrival times.

Reconstruct shipment timelines autonomously

The `get_shipment_events` tool retrieves historical milestones and customs events for any active shipment ID. Windsurf uses these event logs to construct a chronological timeline, highlighting where delays occurred. When a customer asks about a delayed order, Cascade triggers this tool, analyzes the milestone logs, and drafts an accurate response based on the actual port events. You don't write a single line of API integration code.

Setup guide

Set up SafeCube Container Tracking MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the SafeCube Container Tracking MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my SafeCube Container Tracking payment history." If connected, Cascade will call the SafeCube Container Tracking tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "safecube-container-tracking-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Windsurf

Open your `mcp_config.json` file in Windsurf or go to Settings and find the MCP Servers UI. Paste the Vinkius-provided connection URL under the `mcpServers` key and click refresh. Cascade instantly discovers the four tracking tools and makes them available for your next prompt.

Yes, Cascade manages execution pacing. If you ask it to track fifty containers, it chains the `get_container_tracking` calls sequentially to avoid triggering rate limits on the SafeCube API.

While the server doesn't push alerts, Windsurf can run background loops using `get_shipment_events` to check for status changes. Cascade watches for new customs milestones or port departures and updates your workspace automatically.

You run the `check_api_status` tool. If Cascade encounters connection issues while pulling container histories, it calls this endpoint to determine if the issue lies with the SafeCube servers or your local network.

It only handles container IDs, shipment tokens, and port event logs. This tracking data passes directly through Vinkius's secure, ephemeral V8 sandboxes to your local Windsurf client, meaning your logistics data is never stored or used to train external models.

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