How to Use the KDniao MCP in Windsurf

Q: How does KDniao handle carrier routing within Windsurf?

Cascade uses the MCP Server to call identifycarrier to scan tracking numbers and match them to Chinese couriers. It then queries rates using queryshippingprice to choose the most cost-effective option for your package.

Q: What happens when a KDniao pickup fails in Windsurf?

Cascade detects the API error from preorderpickup or onsitepickup and immediately tries a fallback carrier. It keeps you updated in the chat panel with the exact error code from the carrier.

Q: How do I get live delivery updates?

You can use subscribetracking to register your webhook URL. This tells the system to push live status changes directly to your backend whenever a package gets scanned.

Let Windsurf Cascade autonomously handle Chinese logistics using this MCP Server to chain waybill creation and real-time package tracking.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect KDniao MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous Courier Booking with Windsurf

When you tell Cascade to ship an order, it doesn't stop to ask for permission at every step. It immediately fires `identify_carrier` to figure out the best courier, runs `query_shipping_price` to get the cost, and schedules the pickup using `preorder_pickup` or `onsite_pickup` in one continuous run. You get a finished booking and a confirmed pickup time without babysitting the terminal. The agent handles the back-and-forth with KDniao behind the scenes, leaving you with a clean confirmation in your editor.

Automated Waybill Generation

Generating shipping labels for Chinese carriers usually requires digging through messy API documentation. This MCP Server lets your editor generate these labels directly during your checkout development cycle. Cascade takes your order data, reformats the sender and receiver details into the required JSON format, and calls `create_electronic_waybill` to secure your tracking sheet instantly.

Real-time Delivery Monitoring

Tracking packages across multiple Chinese couriers is a headache. Running this MCP Server lets Cascade use `track_package` and `get_estimated_arrival` to pull live status updates directly into your workspace. It can also set up webhook listeners using `subscribe_tracking` so your local development environment receives live delivery updates the second a package moves.

Setup guide

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

mcp_config.json

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

Cascade uses the MCP Server to call `identify_carrier` to scan tracking numbers and match them to Chinese couriers. It then queries rates using `query_shipping_price` to choose the most cost-effective option for your package.

Yes. You can feed Cascade a list of customer addresses, and it will loop through them to run `create_electronic_waybill` for each entry, saving the generated waybill numbers directly to your database.

Cascade detects the API error from `preorder_pickup` or `onsite_pickup` and immediately tries a fallback carrier. It keeps you updated in the chat panel with the exact error code from the carrier.

You can use `subscribe_tracking` to register your webhook URL. This tells the system to push live status changes directly to your backend whenever a package gets scanned.

Your sender and receiver addresses, phone numbers, and package tracking IDs are processed entirely within a secure V8 sandbox. Vinkius never stores this sensitive logistics information, passing it directly to the carrier APIs.

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