How to Use the Heyzine MCP in Windsurf

Q: Can I organize multiple Heyzine collections inside Windsurf?

Yes, you can manage everything. The agent uses listbookshelfflipbooks and addflipbooktobookshelf to sort your digital assets into distinct bookshelves based on your workspace context.

Q: How do I inspect Heyzine design templates from Windsurf?

Ask Cascade to show your available styles. It calls listavailabletemplates and displays the options directly in your chat interface so you can choose the right look.

Q: What happens if an API call fails during conversion?

Cascade automatically runs checkapistatus to diagnose the issue. It reads the error logs, adjusts the parameters, and retries the tool call without breaking your session.

Let Cascade turn raw PDF links into fully customized Heyzine flipbooks and bookshelves inside Windsurf, zero manual steps required.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Heyzine MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade converts and designs your Heyzine flipbooks

The `convert_pdf_to_flipbook` tool lets Windsurf's Cascade agent ingest a raw PDF URL and instantly output an interactive flipbook link. Once Cascade receives the new Heyzine ID, it automatically queries your templates using `list_available_templates` to match your workspace design guidelines. Cascade then triggers `update_flipbook_design` to apply your brand colors and page-turn styles to the Heyzine asset without pausing for user confirmation. You just give Windsurf the document URL, and Cascade handles the conversion and styling in a single autonomous execution.

Auto-manage digital shelves with this Windsurf MCP Server

The `add_flipbook_to_bookshelf` tool allows Windsurf's Cascade agent to organize your converted Heyzine publications into active digital collections. Cascade scans your current project files, determines which documents belong to which shelf, and updates your Heyzine bookshelves in one clean step. If a document becomes obsolete, Cascade runs `remove_flipbook_from_bookshelf` to clean up your live Heyzine displays automatically. It keeps your digital library structured by checking `list_bookshelf_flipbooks` to verify the active inventory right from your Windsurf chat.

Cascade audits your live Heyzine assets

The `get_flipbook_details` tool gives Windsurf's Cascade agent direct access to live Heyzine view counts and publication statuses. Cascade runs this check to generate markdown reports of your flipbook performance directly in your active editor. It also uses `check_api_status` to ensure your Heyzine connection is stable before triggering bulk updates. If any assets need to be pulled, Cascade uses `delete_flipbook` to remove them from your Heyzine account based on your Windsurf instructions.

Setup guide

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

mcp_config.json

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

Cascade chains the tools autonomously. When you supply a PDF, it calls `convert_pdf_to_flipbook` and immediately passes the output ID to `update_flipbook_design` without waiting for your input.

Yes, you can manage everything. The agent uses `list_bookshelf_flipbooks` and `add_flipbook_to_bookshelf` to sort your digital assets into distinct bookshelves based on your workspace context.

Ask Cascade to show your available styles. It calls `list_available_templates` and displays the options directly in your chat interface so you can choose the right look.

Cascade automatically runs `check_api_status` to diagnose the issue. It reads the error logs, adjusts the parameters, and retries the tool call without breaking your session.

Yes. This MCP Server only processes your PDF source URLs and account metadata through a secure, ephemeral V8 sandbox on Vinkius. Your API credentials stay encrypted, and no raw document content is cached or stored on our 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