# Heyzine MCP MCP > Heyzine connects your AI agent directly to professional digital publishing tools. Instantly convert PDFs, Word documents, and PowerPoint files into interactive flipbooks complete with page-turn animations and sharing analytics. Manage entire libraries of branded content using natural conversation. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** flipbooks, digital-publishing, pdf-conversion, interactive-content, document-management, marketing-collateral ## Description Need to turn dense reports or catalogs into something people actually want to read? This MCP lets your agent manage the entire lifecycle of digital publications, giving you full control over distribution without ever touching a complex web editor. You can tell your AI client to take any standard document link—whether it's PDF, DOCX, or PPTX—and convert it instantly into an interactive flipbook. Beyond just conversion, you maintain total command over the published assets; you can organize them into virtual bookshelves and fine-tune every detail of their appearance. It’s about getting those high-impact sales brochures and magazines out fast. Because Vinkius hosts this MCP, your agent accesses all publishing capabilities in one place. You can manage download permissions for security or simply list every single piece of content you own, making it the central hub for your digital marketing assets. ## Tools ### add_flipbook_to_bookshelf Adds a specific flipbook by its ID to an existing collection or bookshelf. ### check_api_status Verifies the current operational status and health of your Heyzine API account. ### convert_pdf_to_flipbook Takes a URL pointing to a PDF document and processes it into an interactive flipbook format, returning its unique ID and public link. ### delete_flipbook Permanently removes a specific published flipbook from your account. ### get_account_info Retrieves general details about your Heyzine account, including usage metrics and subscription type. ### get_bookshelf_details Fetches the name and configuration details for a specific virtual bookshelf collection. ### get_flipbook_details Retrieves comprehensive information, including title and current design settings, for any single flipbook ID. ### list_all_flipbooks Generates a list of every published flipbook currently existing in your account inventory. ### list_bookshelf_flipbooks Lists all flipbook titles that have been grouped together within a specified bookshelf collection. ### list_available_templates Shows the different design templates you can choose from when creating or updating content. ### remove_flipbook_from_bookshelf Removes an individual flipbook from its current collection, making it available elsewhere. ### update_flipbook_design Modifies the visual settings, such as title or background color, for a designated published flipbook. ## Prompt Examples **Prompt:** ``` Convert this PDF to a flipbook: https://example.com/catalog.pdf ``` **Response:** ``` Conversion started! I've successfully triggered the Heyzine engine for your PDF. Your new interactive flipbook will be available shortly at: https://heyzine.com/flip-book/ig_123. Would you like to update its title now? ``` **Prompt:** ``` List all flipbooks in my 'Spring 2026' bookshelf. ``` **Response:** ``` I've retrieved 5 flipbooks from the 'Spring 2026' collection. Notable titles include 'Q1 Product Guide' and 'Regional Brochure'. Which one should we manage or share? ``` **Prompt:** ``` Update the title of flipbook ID 'ig_123' to 'Summer Promo'. ``` **Response:** ``` Done! I've updated the title for flipbook 'ig_123' to 'Summer Promo' in your Heyzine account. The changes are now live on the public link. ``` ## Capabilities ### Convert Documents to Interactive Flipbooks Pass a PDF link and receive a fully formatted, interactive flipbook URL. ### Organize Content into Collections Add individual flipbooks to designated virtual shelves or bookshelves for easy grouping and retrieval. ### Update Design Settings Change the title, background, or overall look of a published flipbook using text instructions alone. ### Manage Account Details Retrieve account status, including subscription limits and API health checks. ### List All Publications Get a complete inventory of every flipbook currently published under your account. ## Use Cases ### Creating a Sales Kit Launch A marketing team needs to launch a new product line. Instead of manually converting 10 different PDFs, they ask their agent: 'Convert these 10 links and organize them into the 'Q3 Product Line' bookshelf.' The agent uses `convert_pdf_to_flipbook` for all ten files and then calls `add_flipbook_to_bookshelf` to complete the kit in one workflow. ### Cleaning Up Old Content A content manager realizes an outdated white paper is still accessible. They ask their agent: 'Find all flipbooks on the 'Archive' shelf and delete the one with ID 'ig_123'.' The agent uses `list_bookshelf_flipbooks` to confirm, then calls `delete_flipbook`. ### Global Branding Update The company changes its primary brand color. Instead of manually editing dozens of files, the content director instructs their agent: 'Update the design for all flipbooks in the 'Client Assets' bookshelf to use hex code #004D99.' The agent uses `update_flipbook_design`. ### Checking Publishing Limits Before running a massive campaign, the publishing lead needs to know if their account can handle the volume. They ask the agent: 'Check our usage limits and API health.' The agent uses `get_account_info` for an immediate status report. ## Benefits - Conversion is automatic. Instead of manually uploading and configuring every document, your agent handles the entire process when you call `convert_pdf_to_flipbook`, giving you an instant, interactive asset URL. - Organization is simple. You can use commands like `add_flipbook_to_bookshelf` to group assets into collections without having to jump between different project folders or dashboards. - Branding control stays high. Need to change a title or update the color scheme across 50 publications? Call `update_flipbook_design`, and your agent handles the bulk changes instantly. - Auditing is fast. If you need to know what content exists, calling `list_all_flipbooks` gives you an immediate inventory of everything published—no digging through dated folders required. - Security works natively. You can use controls to manage download permissions and ensure that certain high-value flipbooks are only viewable by approved parties. ## How It Works The bottom line is you don't use a GUI; your agent talks directly to Heyzine via these specific functions. 1. Subscribe to this MCP and enter your Heyzine API Key (Bearer token) into your agent's configuration. 2. Use natural language commands with your AI client, instructing it on the desired action (e.g., 'Convert this PDF link'). 3. The MCP executes the command, returning the necessary IDs or URLs for the newly created asset or updated setting. ## Frequently Asked Questions **How do I convert my existing PDFs using the Heyzine MCP?** You call `convert_pdf_to_flipbook` and provide a public URL for your PDF. The tool handles the conversion process, giving you back a unique flipbook ID and the live link. **Can I organize my flipbooks into collections using Heyzine MCP?** Yes. First, use `list_all_flipbooks` to get the IDs of your documents. Then, tell the agent which ones belong together and call `add_flipbook_to_bookshelf` for each one. **I need to change the title across 10 different flipbooks; what tool do I use?** Use `update_flipbook_design`. You pass the specific ID of the flipbook and the new text you want for the title. Your agent handles the update for each item. **What if a bookshelf is empty or I need to see what's in it?** You can first use `get_bookshelf_details` to check the shelf name, and then run `list_bookshelf_flipbooks` to retrieve a list of all content currently stored there. **How do I check my current subscription status or API limits using the `get_account_info` tool?** The `get_account_info` tool pulls your active usage data and remaining quota. It shows exactly how many conversions you've used this month, helping you plan for high-volume publishing runs. **When I run `get_flipbook_details`, where do I manage the download permissions for a specific flipbook?** The details page accessed via `get_flipbook_details` shows all current privacy settings. You can adjust who has permission to download the file, ensuring your proprietary content stays secure. **If I need to remove an old or unused document, what does the `delete_flipbook` tool do?** The `delete_flipbook` tool permanently removes the publication and all associated assets from your account. Be careful; once deleted, you can't get it back. **Before I start a batch job, how can I verify the overall service health using `check_api_status`?** Running `check_api_status` immediately confirms if Heyzine is online and accepting commands. A successful response means your agent is good to go for publishing tasks. **How do I find my Heyzine API key?** Log in to your Heyzine account and navigate to the **API** section in your dashboard to generate or copy your unique Bearer token. **What file formats can be converted into flipbooks?** Heyzine currently supports PDF, DOCX, and PPTX files for seamless conversion into professional interactive digital publications. **Can I manage bookshelves through this AI integration?** Yes! Use the `list_bookshelves` and `add_to_bookshelf` tools to organize your flipbooks into collections for easier access and distribution.