How to Use the GitBook MCP in Windsurf

Let Windsurf Cascade autonomously crawl, search, and audit your GitBook spaces to keep your team's docs accurate.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect GitBook MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map your entire GitBook space hierarchy

The `list_spaces` tool lets your agent grab every active workspace under your GitBook organization without manual clicking. Cascade takes this list, chains it with `list_pages`, and builds a complete structural map of your technical documentation in seconds. You don't have to point Windsurf to individual URLs anymore. Cascade finds the right GitBook space, inspects the layout, and knows exactly where your documentation lives before it writes a single line of local code.

Let Windsurf audit and search content autonomously

The `search_content` tool allows Cascade to scan your entire GitBook library for specific keywords, outdated APIs, or missing setup steps. Running deep queries across your knowledge base extracts matching text blocks without pulling unnecessary noise. Once Cascade locates the draft pages, it pulls the exact markdown using `get_page`. By comparing your live code against your written GitBook guides, the agent spots the discrepancies and flags them for you to fix.

Audit documentation collections and structure

The `list_collections` tool gives your agent the ability to inspect how your GitBook spaces are grouped inside your organization. Checking the high-level hierarchy alongside `list_organizations` ensures your customer-facing guides aren't mixed up with internal notes. This MCP server helps Cascade verify if a new product feature has a corresponding public GitBook document. If it finds gaps in the collections, it tells you what pages are missing.

Setup guide

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

mcp_config.json

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

You add the MCP server configuration to your local config file, and Cascade immediately reads the available tools. It can then autonomously chain operations like listing spaces and grabbing page content to answer your documentation questions.

Yes, Cascade can run search queries directly using the search tool. It finds relevant pages, pulls their raw text, and uses that context to write accurate code that matches your actual API setup.

No, this GitBook integration is read-only to prevent Windsurf from accidentally overwriting your production guides. Cascade can find errors and draft the corrections in your local workspace, but you or your writers will make the final updates in the browser.

The agent handles large spaces by listing pages in batches. It won't choke on huge documentation sites because it queries the structure first before fetching individual page contents.

Your GitBook page content, space settings, and organization structure are processed locally on your machine through the Vinkius secure MCP sandbox. No external servers store your documentation data, keeping your internal guides completely private.

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