Calibre-Web MCP Server for WindsurfGive Windsurf instant access to 3 tools to Get Opds Catalog, Get Opds Shelf, Sync Kobo Library

Name: Calibre-Web
Price: 29 USD
Availability: InStock
Rating: 5.0 (1 reviews)
Author: Vinkius

GDPR Free for Subscribers

Windsurf brings agentic AI coding to a purpose-built IDE. Connect Calibre-Web through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.

Ask AI about this MCP Server for Windsurf

Open in ChatGPT Open in Claude Open in Perplexity

The Calibre-Web MCP Server for Windsurf is a standout in the Knowledge Management category — giving your AI agent 3 tools to work with, ready to go from day one.

Built for AI Agents by Vinkius

Vinkius delivers Streamable HTTP and SSE to any MCP client

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

+ other MCP clients

Classic Setup·json

{
  "mcpServers": {
    "calibre-web": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

RecommendedModern Approach — Zero Configuration

Vinkius Desktop App

The modern way to manage MCP Servers — no config files, no terminal commands. Install Calibre-Web and 4,000+ MCP Servers from a single visual interface.

Download Free Open SourceNo signup required

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Calibre-Web MCP Server

Connect your Calibre-Web instance to any AI agent and interact with your digital book collection using natural language. This server provides tools to navigate your library structure and prepare books for e-reader synchronization.

Windsurf's Cascade agent chains multiple Calibre-Web tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 3 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.

What you can do

OPDS Catalog Access — Retrieve the main OPDS XML feed to browse your entire library structure, categories, and recent additions.
Shelf Browsing — Query specific shelf IDs to list books within curated collections or user-defined categories.
Kobo Synchronization — Fetch structured metadata and secure download links optimized for Kobo devices using your dedicated sync token.
Library Inspection — Use the AI to find specific book entries and metadata within your self-hosted instance.

The Calibre-Web MCP Server exposes 3 tools through the Vinkius. Connect it to Windsurf in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

All 3 Calibre-Web tools available for Windsurf

When Windsurf connects to Calibre-Web through Vinkius, your AI agent gets direct access to every tool listed below — spanning ebooks, calibre, opds, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.

get

Get opds catalog on Calibre-Web

Useful for browsing the library structure. Get the main OPDS catalog feed

get

Get opds shelf on Calibre-Web

Get the OPDS feed for a specific shelf

sync

Sync kobo library on Calibre-Web

Requires Kobo Token. Sync Kobo library

Connect Calibre-Web to Windsurf via MCP

Follow these steps to wire Calibre-Web into Windsurf. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"

Add the server

Paste the JSON configuration above into mcp_config.json

Save and reload

Windsurf will detect the new server automatically

Start using Calibre-Web

Open Cascade and ask: "Using Calibre-Web, help me...". 3 tools available

Why Use Windsurf with the Calibre-Web MCP Server

Windsurf provides unique advantages when paired with Calibre-Web through the Model Context Protocol.

Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention

Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively

JSON-based configuration means zero code changes: paste a URL, reload, and all 3 tools are immediately available

Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts

Calibre-Web + Windsurf Use Cases

Practical scenarios where Windsurf combined with the Calibre-Web MCP Server delivers measurable value.

Automated code generation: ask Cascade to fetch data from Calibre-Web and generate models, types, or handlers based on real API responses

Live debugging: query Calibre-Web tools mid-session to inspect production data while debugging without leaving the editor

Documentation generation: pull schema information from Calibre-Web and have Cascade generate comprehensive API docs automatically

Rapid prototyping: combine Calibre-Web data with Cascade's code generation to scaffold entire features in minutes

Example Prompts for Calibre-Web in Windsurf

Ready-to-use prompts you can give your Windsurf agent to start working with Calibre-Web immediately.

"Retrieve the main OPDS catalog from my library."

"Show me the books available on shelf ID 5."

"Sync my Kobo library and provide the download links."

Troubleshooting Calibre-Web MCP Server with Windsurf

Common issues when connecting Calibre-Web to Windsurf through Vinkius, and how to resolve them.

Server not connecting

Check Settings → MCP for the server status. Try toggling it off and on.

Calibre-Web + Windsurf FAQ

Common questions about integrating Calibre-Web MCP Server with Windsurf.

How does Windsurf discover MCP tools?

Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.

Can Cascade chain multiple MCP tool calls?

Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.

Does Windsurf support multiple MCP servers?

Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.