How to Use the ShipStation MCP in Windsurf

Q: How do I list all my connected carriers in ShipStation using Windsurf?

It's simple: run listcarriers. This tool pulls a clean list of every carrier account you’ve linked to the MCP Server. You won't have to guess which services are available; it lists them right up front.

Q: How do I ensure Windsurf only processes orders for a specific region in ShipStation?

You can use listwarehouses and then filter your order searches using the relevant location IDs. The MCP Server treats these warehouse locations as critical inputs, ensuring that fulfillment requests are tied to the correct shipping origin.

Q: What data type does this ShipStation MCP Server touch when voiding a label?

The server primarily touches the label ID and the associated order ID. This means it knows exactly which physical shipment is being canceled, keeping your records clean.

From order fetch to label printing—Windsurf handles the whole shipping flow using the ShipStation MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect ShipStation MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Need to get rates? Use this capability.

Run `get_rates` when you need real-time costs. You feed it a package's dimensions and weight, and the MCP Server returns available shipping options from connected carriers (like UPS or USPS). It doesn't just give one price; it gives you multiple routes to compare cost versus speed. This tool is key for figuring out optimal shipping methods before committing an order. You can also call `get_carrier` if you need to check a specific account balance first, which keeps your fulfillment workflow running smoothly.

Tracking shipments in ShipStation.

`list_orders` lets you pull down any order list using filters. You can filter by date range or status, so you only see what needs attention right now. Better yet, `list_orders_by_tag` helps you target specific groups of orders—say, everything tagged 'International' or 'Rush Shipment'. Once the agent identifies an order that shipped out, it uses `mark_as_shipped`. This updates ShipStation with tracking details, which is crucial for keeping customer records accurate and preventing double-labeling.

Printing labels for Windsurf.

`create_label_for_order` handles the final step: generating the label. You hand it an order ID, and the MCP Server spits out a ready-to-print shipping label using confirmed rates. This is your go-to tool when you're done calculating and know exactly what carrier to use. Need something manual? If the order process gets messy, `create_shipment_label` lets you bypass the full order flow and make a label with just basic shipment details. It’s useful for those weird exceptions that don’t fit the standard workflow.

Setup guide

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

mcp_config.json

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

It's simple: run `list_carriers`. This tool pulls a clean list of every carrier account you’ve linked to the MCP Server. You won't have to guess which services are available; it lists them right up front.

Yeah, absolutely. If an order gets canceled or redirected before pickup, you use `void_label`. This tool voids a specific shipping label ID within the MCP Server and updates the status so no one tries to print it again.

If you run low on credit or need to cover unexpected costs, call `add_funds`. You just specify the carrier account and the amount needed. The MCP Server handles adding those necessary dollars to your balance.

You can use `list_warehouses` and then filter your order searches using the relevant location IDs. The MCP Server treats these warehouse locations as critical inputs, ensuring that fulfillment requests are tied to the correct shipping origin.

The server primarily touches the `label ID` and the associated `order ID`. This means it knows exactly which physical shipment is being canceled, keeping your records clean.

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