How to Use the Moova MCP in Windsurf

Stop manual logistics entry. Let Windsurf handle your shipping lifecycle by automating carrier selection and tracking updates.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Moova MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate shipping with Windsurf

Cascade doesn't just look up data. You tell it to ship a package, and it executes `create_shipment` by pulling addresses directly from your codebase. It handles the carrier assignment and routing without you typing a single line of JSON. Once the order is set, it pulls the `get_shipment_label` automatically. Your workflow stays inside the IDE while the agent manages the logistics backend.

Live status tracking in Windsurf

Stop refreshing carrier websites. Use `get_shipment_status` to have Cascade pull live updates into your project files. It identifies delays before your customers do. You can also set up `create_webhook` to pipe events directly into your logs. The agent manages the registration, keeping your delivery data synced in real-time.

Cost-effective routing for Windsurf

Before you commit to a carrier, let the agent run `get_budget`. It compares express and standard rates to keep your shipping costs predictable. If you need to adjust, use `update_shipment` before the package leaves the warehouse. Everything stays in sync with your local dev environment through this MCP server.

Setup guide

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

mcp_config.json

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

You add the server settings to your configuration file. Once connected, Cascade automatically discovers all 14 tools and starts executing tasks when you give it a goal.

Yes. You can prompt the agent to list and process pending orders. It uses `list_shipments` to find what needs attention and executes the necessary API calls.

The MCP server is accessible to the agent regardless of where you are in the IDE. You can trigger shipping tasks from a chat prompt or an agent-led workflow.

The agent receives the error response from the tool. You can ask it to check `get_shipment` details to troubleshoot the specific address or package dimension issue.

Your package dimensions, addresses, and contact details stay within your secure connection. The server only processes the specific data required to generate labels and tracking events.

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