How to Use the Calibre-Web MCP in Vercel AI SDK

Connect your Calibre-Web library directly to Next.js or React frontends using the Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Calibre-Web MCP to Vercel AI SDK

Create your Vinkius account to connect Calibre-Web to Vercel AI SDK 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 Calibre-Web with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream OPDS Catalogs Directly into React

Vercel AI SDK excels at pushing live data straight to the DOM. When your agent calls `get_opds_catalog`, the tool fetches your main library feed while the UI updates instantly. Users see book titles and authors appear without staring at a loading spinner. This changes how you build reading apps. You pass the MCP Server endpoint into your setup logic, and suddenly your Next.js frontend has full access to your server's entire structure.

Build Live Interfaces for Specific Shelves

Fetching a massive library all at once bogs down edge functions. Instead, you target exact collections using `get_opds_shelf`. The AI client grabs only the relevant XML feed for that specific shelf ID. Your React components render the results as they stream in. Because the SDK handles the transport layer natively, you just pass the tool to the stream function and let the Vinkius infrastructure manage the connection.

Trigger Kobo Syncs via Vercel AI SDK MCP Server

Managing e-readers usually requires manual intervention. Now your web application can push updates straight to connected devices by calling `sync_kobo_library`. The agent passes the required Kobo token, and the backend handles the synchronization. You get immediate feedback on the sync status. End users click a button in your Svelte or Vue interface, the SDK fires the tool, and the result streams back confirming the device is up to date.

Setup guide

Set up Calibre-Web MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Calibre-Web tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Calibre-Web transactions",
});

console.log(text);
await mcpClient.close();

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 Calibre-Web. 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 Calibre-Web 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 Calibre-Web MCP in Vercel AI SDK

Install the required packages and use the client creator with your Vinkius endpoint. Pass the resulting tools into your generation calls. Always close the client when the interaction finishes.

Yes, the OPDS feeds contain image URLs. As the catalog tool streams the XML response into your React frontend, you can parse those URLs and render the covers live.

Vinkius manages the primary server connection via an endpoint token. If you need specific user authentication for OPDS feeds, you pass those credentials through the auth provider in your setup.

The standard API requires writing custom fetch logic and parsing XML manually. This MCP Server exposes typed tools that your AI agent understands natively, cutting out the boilerplate.

Your Kobo tokens and OPDS feed metadata stay isolated within the V8 sandbox during execution. Vinkius spins up an ephemeral instance for the request and destroys it immediately after. No reading habits or auth tokens are logged.

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