How to Use the Arrivy MCP in Windsurf

Q: Can I create new customers and tasks in Arrivy from Windsurf?

Yes. Just tell Windsurf the details. It uses the createcustomer and createtask tools to add new records to Arrivy without you needing to open the web app.

Let Windsurf's Cascade agent run your entire Arrivy dispatch. Assign tasks, manage crews, and update jobs without touching the Arrivy UI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Arrivy MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Multi-Step Logistics in One Prompt

This is where the Arrivy MCP Server shines with Windsurf. Give Cascade a high-level goal, like "Get the next job ready for the Delta crew." It will chain the tools itself: `list_crews` to find the crew, `list_tasks` to find their next task, and `update_task` to assign it. You don't prompt each step. Cascade can also handle creating new work from scratch. A prompt like "Book a plumbing job for our new client, John Doe, at his office" will trigger `create_customer` and then `create_task`, linking the two records automatically. You just see the result.

Get Real-Time Field Intel with this MCP Server

Pull live Arrivy data right into your editor. Ask Windsurf, "Show me all active tasks in the downtown area," and it will use `list_tasks` and `list_locations` to get you a straight answer. No more switching tabs to check the Arrivy dashboard. You can get specific, too. Use `get_task` to pull up the details for a single job, or run `list_crews` to see who is on shift and what their current status is. It's all just conversationally available.

Manage Bookings and Crews from Windsurf

Handle the day-to-day operations directly. Create a new client record with `create_customer` or add a new job to the board with `create_task`. Your agent will prompt for any missing info and confirm once it's done. This is the power of a good MCP setup. Task management is just as simple. Need to reassign a job or change its status? The `update_task` tool lets you modify existing tasks by just telling Windsurf what needs to change.

Setup guide

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

mcp_config.json

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

Cascade sees all the Arrivy tools and can chain them together to complete a goal. You tell it what you want done—like assigning a task—and it figures out the sequence of `list_crews` and `update_task` calls needed to do it. It's fully autonomous.

Yes. Just tell Windsurf the details. It uses the `create_customer` and `create_task` tools to add new records to Arrivy without you needing to open the web app.

You can list all current tasks, customers, field crews, and service locations. You can also get the specific details for any single task using its ID. It's the same data you'd see in the Arrivy dashboard.

Connecting this MCP Server is simple. Use the built-in MCP Marketplace in Windsurf for a one-click install, or manually add the server endpoint to your `mcp_config.json` file.

Your Arrivy customer, task, and crew data is streamed directly to your local Windsurf client through a secure, ephemeral Vinkius sandbox. The connection is encrypted, and your credentials are never logged or stored on the MCP Server itself.

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