How to Use the Ship24 MCP in Windsurf

Q: What if I need to find out which carriers Ship24 supports for my region?

Run the searchcouriers tool directly in Cascade. It queries the entire supported list, letting you filter by country or specific service types without needing a manual database lookup.

Q: If I need to update metadata for a tracker, what tools are available with Ship24 and Windsurf?

You can use updatetrackerinfo to modify the associated data points. This lets you keep your internal records accurate, even after the tracking status has changed.

Get real-time global tracking data using your AI client's autonomous power.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ship24 MCP to Windsurf

Create your Vinkius account to connect Ship24 to Windsurf 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 Ship24 with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Bulk Tracking Status

Need to check dozens of shipments at once? Cascade runs the `create_bulk_trackers` tool, taking a list of tracking numbers and getting them all into one queue. You tell it the goal—'Find status for these 50 items'—and Cascade figures out how to get the results. It handles the follow-up steps, using tools like `get_tracking_results` until every package has a final status update or hits a known error code.

Live Tracking Updates

Tracking doesn't stop just because you checked once. Use the `get_live_tracking` tool to pull the absolute latest updates from 1200+ carriers instantly. It bypasses static data by connecting directly and pulling granular location changes. This is perfect for building complex pipelines: Cascade can continuously monitor a tracker, checking every hour until it hits 'delivered' or fails the check.

Carrier Code Discovery

Don't waste time guessing carrier codes. The `list_couriers` tool spits out a list of all supported carriers and their codes, saving you manual lookups. You can also use `search_couriers` to narrow down the list based on geography or service type. This makes building reliable tracking logic way easier. It's like having the carrier directory right in your agent's toolkit.

Setup guide

Set up Ship24 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 Ship24 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 Ship24 payment history." If connected, Cascade will call the Ship24 tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "ship24-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 Ship24. 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 Ship24 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 Ship24 MCP in Windsurf

You set a goal, and Cascade takes care of the rest. For example, you tell it: 'Check all active trackers for any delays.' It then autonomously uses `list_active_trackers`, checks each one with `get_tracking_results`, and reports back only what's delayed.

Absolutely. Since the MCP Server exposes standardized tools, your agent can treat tracking status like any other API call. You can build a workflow that runs checks overnight and logs failures.

Run the `search_couriers` tool directly in Cascade. It queries the entire supported list, letting you filter by country or specific service types without needing a manual database lookup.

Yes. The MCP Server manages connectivity details, ensuring that the agent doesn't overload any single carrier API endpoint while executing multi-step tasks.

You can use `update_tracker_info` to modify the associated data points. This lets you keep your internal records accurate, even after the tracking status has changed.

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