How to Use the Guidebook MCP in Windsurf

Q: How do I add this Guidebook MCP Server to my Windsurf environment?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers key. Alternatively, go to Settings, select Cascade, and use the MCP Servers UI to connect the endpoint instantly.

Q: Can Cascade use Guidebook tools to update mobile schedules in Windsurf?

Yes, Cascade chains listsessions and getsession to read your current guide setup. It analyzes your local codebase, compares it with the live event data, and flags what needs to be changed.

Q: How does Windsurf handle API rate limits when updating Guidebook data?

Windsurf uses the getratelimit tool to monitor your remaining API allowance during execution. Cascade checks this limit before running large batch operations to prevent your updates from getting throttled.

Q: Can I manage custom sponsor lists through Cascade?

Absolutely. Your agent calls listcustomlists to pull exhibitors and sponsors directly into your Windsurf workspace. This lets you inspect the exact layout attendees see on their mobile devices.

Direct your Windsurf Cascade agent to update event schedules, speaker profiles, and sponsor lists inside your Guidebook mobile app.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Guidebook MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Sync Event Schedules Autonomously in Windsurf

The `list_sessions` tool exposes your entire mobile event schedule to Cascade so the agent can audit timing conflicts. Cascade reads your local markdown schedule, fetches the live Guidebook data, and identifies mismatching session blocks without human intervention. Once Cascade finds a discrepancy, it pulls specific event details using `get_session` to verify the room assignments. You just tell the agent to fix the schedule, and it chains these calls to resolve layout issues in the IDE.

Match Speaker Profiles to Sessions via MCP Server

The `list_speakers` tool lets your Windsurf agent scan through presenter profiles to align them with their scheduled slots. Cascade maps speaker bios directly to session IDs by pulling details with `get_speaker` in a single autonomous run. If a speaker bio is missing, Cascade flags the gap in your workspace and prepares a list of missing assets. This MCP Server connection ensures your mobile app content matches your local repository files before you deploy.

Track Venue Locations and Custom Lists

The `list_locations` tool retrieves all defined physical venues and rooms from your Guidebook account directly into Cascade. Your agent uses this data to update local map components and verify room capacities against session sizes. To handle sponsor booths or exhibitor directories, the agent calls `list_custom_lists` to pull custom items into your workspace. Windsurf coordinates these asset checks in the background while you write your main app logic.

Setup guide

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

mcp_config.json

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

Open your ~/.codeium/windsurf/mcp_config.json file and add the server configuration under the mcpServers key. Alternatively, go to Settings, select Cascade, and use the MCP Servers UI to connect the endpoint instantly.

Yes, Cascade chains `list_sessions` and `get_session` to read your current guide setup. It analyzes your local codebase, compares it with the live event data, and flags what needs to be changed.

Windsurf uses the `get_rate_limit` tool to monitor your remaining API allowance during execution. Cascade checks this limit before running large batch operations to prevent your updates from getting throttled.

Absolutely. Your agent calls `list_custom_lists` to pull exhibitors and sponsors directly into your Windsurf workspace. This lets you inspect the exact layout attendees see on their mobile devices.

Your event schedules, speaker bios, and sponsor lists are processed locally inside Windsurf's secure runtime. The connection uses your private endpoint token, meaning no event agenda details are stored on external intermediate 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