How to Use the Giddyup MCP in Windsurf

Q: How does Giddyup connect to the Windsurf Cascade agent?

You register the Giddyup MCP Server inside your mcpconfig.json file under the mcpServers key. Cascade automatically reads the 13 tools upon startup. You can then ask Cascade to schedule jobs or check lead statuses using natural language.

Q: Can Windsurf Cascade write to my Giddyup dispatch board?

Yes, Cascade uses createjob and updatejob to modify your dispatch schedule directly. It chains these commands autonomously based on your instructions. You can monitor every change it makes inside the Windsurf terminal.

Let Windsurf Cascade handle your dispatch board, coordinate technicians, and update jobs in real time without manual coordination.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Giddyup MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Dispatching with Windsurf Cascade

The Giddyup MCP Server lets Windsurf Cascade look at your field queue and act without waiting for permission. It calls `list_jobs` to see who is waiting, matches them with technicians via `list_users`, and schedules the work instantly. You get clean schedules without clicking through five different browser tabs. When emergencies hit, the agent handles the chaos. It triggers `update_job` to shift routes and uses `get_customer` to pull contact details for rapid updates. This keeps your field crew moving while you stay focused on higher-priority tasks.

Convert Leads to Jobs Instantly

Giddyup integrates directly with Windsurf Cascade to stop you from copying data from emails to your CRM. Cascade reads incoming requests, runs `create_lead` to log the opportunity, and tracks progress using `get_lead`. The agent handles the administrative pipeline so your sales team can focus on closing deals. Once a customer signs off, Cascade turns that lead into a scheduled service call. It uses `create_job` to build the work order and matches it to the right field tech. You do not have to touch a single form to keep the pipeline moving.

Track Invoice Status and System Health

This Giddyup integration keeps cash flow steady by letting Windsurf audit your accounts. Cascade runs `list_invoices` to find outstanding balances and flags accounts that need attention. It links invoices directly to customer profiles retrieved through `list_customers`. Before running heavy batch updates, Cascade checks the MCP Server connection. It queries `check_giddyup_status` to ensure the API is fully responsive. This prevents broken workflows and keeps your data clean.

Setup guide

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

mcp_config.json

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

You register the Giddyup MCP Server inside your `mcp_config.json` file under the `mcpServers` key. Cascade automatically reads the 13 tools upon startup. You can then ask Cascade to schedule jobs or check lead statuses using natural language.

Yes, Cascade uses `create_job` and `update_job` to modify your dispatch schedule directly. It chains these commands autonomously based on your instructions. You can monitor every change it makes inside the Windsurf terminal.

No, this integration requires an active internet connection to communicate with the field service platform. The MCP Server runs `check_giddyup_status` to verify live connectivity before executing dispatch updates. If the API is down, Cascade will notify you immediately.

Yes, you can configure the MCP settings to restrict API token permissions to read-only endpoints. If your token only allows GET requests, tools like `update_job` will fail safely. This ensures Cascade only queries information without modifying live schedules.

All customer phone numbers, addresses, and technician location coordinates are processed locally inside a secure V8 isolate sandbox. Your field data never passes through third-party servers. Vinkius handles authentication securely, ensuring only authorized team members can pull customer records.

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