How to Use the Cloudbeds MCP in Windsurf

Q: Can I update room status in Windsurf with Cloudbeds?

Yes. Windsurf uses the gethousekeeping tool to pull current room states. Cascade matches this data with listrooms to help you coordinate cleaning schedules directly from your editor.

Q: How do I install this Cloudbeds MCP Server in Windsurf?

Open your Windsurf settings and add the server to your mcpconfig.json file. Cascade automatically discovers all ten tools, including listtransactions and getguest, the moment you reload.

Q: Does this integration support financial transaction tracking?

Yes, you can track every payment. The listtransactions tool pulls financial histories for any specific booking ID, letting your agent audit folio balances instantly.

Run your entire hotel front desk autonomously inside Windsurf with Cascade chaining your Cloudbeds data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cloudbeds MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade automates front desk check-ins

`list_reservations` pulls your active arrivals so Cascade can plan the daily check-in sequence. Your Windsurf agent grabs reservation details, checks room statuses, and flags dirty rooms before guests arrive at the desk. It chains `get_housekeeping` to find clean rooms and matches them to incoming guests instantly. You get a ready-to-go plan without clicking through five different browser tabs.

Cloudbeds MCP Server handles booking audits

`get_dashboard` lets Cascade audit your room revenue against actual occupancy by pulling the day's financial metrics. Your Windsurf agent calls this tool to match daily earnings against transaction logs. Cascade runs `list_transactions` across all active files to catch billing discrepancies. It flags unpaid balances and updates guest profiles without you writing a single SQL query.

Automate VIP guest preparation

`search_guests` finds returning high-value profiles so Cascade can prep their arrival. Your Windsurf agent pulls lifetime value and past preferences to coordinate VIP setups. It then chains `check_availability` to find room upgrades and updates the booking via `get_reservation`. You run one prompt and Cascade handles the entire hospitality workflow.

Setup guide

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

mcp_config.json

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

Cascade reads your prompt and decides which tools to chain together. It calls `get_dashboard` to see daily metrics, then runs `list_reservations` to dig into specific bookings without requiring step-by-step prompts.

Yes. Windsurf uses the `get_housekeeping` tool to pull current room states. Cascade matches this data with `list_rooms` to help you coordinate cleaning schedules directly from your editor.

Open your Windsurf settings and add the server to your `mcp_config.json` file. Cascade automatically discovers all ten tools, including `list_transactions` and `get_guest`, the moment you reload.

Yes, you can track every payment. The `list_transactions` tool pulls financial histories for any specific booking ID, letting your agent audit folio balances instantly.

Your guest profiles and financial transactions remain secure because Vinkius runs this MCP Server in an isolated, zero-trust sandbox. Windsurf only accesses the specific Cloudbeds endpoints you authorize, and no guest data is ever stored on external servers.

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