How to Use the FareHarbor MCP in Windsurf

Q: Can Cascade in Windsurf book tours on FareHarbor autonomously?

Yes, Cascade uses createbooking to write new reservations directly to your account. It plans the execution, verifies availability first, and completes the booking without requiring step-by-step prompts.

Q: Can I filter activities by operator?

Use listcompanies to identify the specific operator ID first. Then pass that ID to listitems to pull the exact activities managed by that operator.

Run your entire tour booking desk directly inside Windsurf with Cascade chaining complex FareHarbor operations automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect FareHarbor MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Autonomous Inventory Audits in Windsurf

The `list_items` tool lets Cascade pull your entire activity catalog to check live availability against upcoming dates. Instead of asking you for permission at every step, the agent grabs the item list, runs `list_availabilities_by_range` to scan for open slots, and flags overbooked tours immediately in your editor. When Cascade spots a scheduling conflict, it doesn't just stop. It uses `get_availability` to dig into the specific slot details and drafts a resolution plan right in your Windsurf chat window.

Direct Booking Generation

The `create_booking` tool enables Windsurf to reserve spots using this MCP Server. You tell Cascade to book a group of ten for the sunset sail, and it automatically checks `get_item_details` to verify age limits and pricing before finalizing the reservation. Cascade chains these steps by pulling lodging info via `list_lodgings` to assign pickup locations instantly. You get a complete booking confirmation without leaving your coding environment.

Live Customer Record Lookups

The `get_booking` tool retrieves complete reservation details using a UUID directly inside the Cascade interface. If a customer calls about a change, you paste the ID into Windsurf, and the agent pulls up the record, checks the associated company using `list_companies`, and displays the status. By combining `list_bookings` with Windsurf's context awareness, Cascade can cross-reference recent transactions to spot billing discrepancies. It handles the entire verification sequence in a single autonomous pass.

Setup guide

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

mcp_config.json

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

Open your Windsurf Settings, go to Cascade, and access the MCP Servers UI to add the server. You can also edit your `~/.codeium/windsurf/mcp_config.json` file directly to register the connection.

Yes, Cascade uses `create_booking` to write new reservations directly to your account. It plans the execution, verifies availability first, and completes the booking without requiring step-by-step prompts.

Windsurf manages requests sequentially when Cascade chains tools via the MCP. This keeps your API calls within bounds while pulling live calendar updates.

Use `list_companies` to identify the specific operator ID first. Then pass that ID to `list_items` to pull the exact activities managed by that operator.

Your customer data is safe. This integration runs inside a secure V8 sandbox, meaning sensitive booking UUIDs, customer names, and lodging locations are never exposed or stored outside your local session.

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