# Gotenberg MCP for AI Agents AI Agent Connect

> Gotenberg lets you turn web pages, raw HTML, Markdown, and Office files into high-quality PDFs or screenshots. It handles the heavy lifting of document conversion and manipulation, like merging files, splitting pages, and editing metadata, so your agent can manage complex document workflows without you having to open a single editor.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_IkDIVkylexUE9eZzBPNF2NCeizigqyr4NO7jaNq0/ai-agent-connect
- **Tags:** pdf-generation, html-to-pdf, web-screenshot, libreoffice-conversion, pdf-manipulation

## Description

Connecting this Connector to your workflow means you can finally stop manually exporting files to share with clients or teammates. Instead of jumping between browser tabs to print to PDF or messing with complex layout settings in a word processor, you just tell your agent what you need. It handles the rendering of live URLs, raw code, or messy notes into polished documents instantly. If you need to take a screenshot of a specific web layout or turn a collection of separate reports into one unified file, this is the engine that does it. It even handles the tedious stuff like embedding attachments into PDFs or updating metadata so your files actually look professional. By using Vinkius to manage this connection, you get a reliable way to automate document generation at scale. It's about moving from I need to make a PDF of this to here is the PDF, without the middle steps of manual formatting or file management.

## Tools

### get_health
Check if your Gotenberg instance is running correctly. Use this to verify your connection status.

### convert_office_to_pdf
Turn Word, Excel, or PowerPoint files into PDFs using LibreOffice. This is perfect for batch converting office documents.

### convert_markdown_to_pdf
Turn Markdown notes into high-quality PDF documents using Chromium. Use this to turn notes into polished guides.

### convert_url_to_pdf
Convert a live web URL into a base64 encoded PDF. This lets you save web pages as documents instantly.

### embed_pdf_attachments
Add files as attachments directly into a PDF document. It keeps all your related files in one place.

### merge_pdfs
Combine multiple PDF files into a single, unified document. It's the easiest way to consolidate reports.

### read_pdf_bookmarks
Pull the bookmark list from an existing PDF file. Use this to understand the structure of a document.

### read_pdf_metadata
View the hidden metadata stored inside a PDF file. This helps you see the author, title, and creation date.

### screenshot_html
Capture a screenshot of raw HTML code as an image. This is great for previewing web components.

### screenshot_markdown
Take a screenshot of Markdown content for quick previews. Use this to visualize your notes as rendered pages.

### screenshot_url
Capture a live web page as a base64 encoded image. This saves you from manual screen captures.

### split_pdf
Break a large PDF into multiple files and receive them as a ZIP. This helps in breaking down long reports.

### get_version
Check which version of Gotenberg your instance is running. Use this for troubleshooting your connection.

### write_pdf_bookmarks
Add or update bookmarks within a PDF document. This helps organize long documents for your readers.

### write_pdf_metadata
Update the metadata of an existing PDF file. Use this to ensure your files have the correct titles and tags.

### convert_html_to_pdf
Turn raw HTML code into a base64 encoded PDF. This is your go-to for turning web code into documents.

## Prompt Examples

**Prompt:** 
```
Convert this URL to a PDF and tell me if it worked.
```

**Response:** 
```
I've processed the URL and generated a PDF for you. You can find the base64 encoded document ready for download.
```

**Prompt:** 
```
Can you merge these three PDFs into one file?
```

**Response:** 
```
I've merged those three documents into a single PDF. Here is the link to your unified file.
```

**Prompt:** 
```
Take a screenshot of this HTML code: <h1>Hello World</h1>
```

**Response:** 
```
I've captured that HTML as a PNG screenshot. You can see the rendered image below.
```

## Capabilities

### Turn URLs into PDFs
Convert live web pages into high-quality PDF documents automatically.

### Convert Office files
Transform Word, Excel, and PowerPoint files into PDF format.

### Capture web screenshots
Take screenshots of live URLs or raw HTML as image files.

### Merge PDF documents
Combine multiple PDF files into a single unified document.

### Split PDF files
Break a large PDF into separate files and receive them as a ZIP.

### Edit PDF metadata
Read and write metadata, bookmarks, and attachments within PDF files.

## Use Cases

### Automated Invoice Generation
A developer asks the agent to take a data table and turn it into a PDF invoice using convert_html_to_pdf.

### Monthly Report Compilation
An analyst needs to merge five separate monthly reports into one file using merge_pdfs to share with the board.

### Markdown to PDF Publishing
A writer wants to turn a Markdown blog post into a printable PDF guide using convert_markdown_to_pdf.

### Web Page Archiving
A researcher wants to save a live URL as a screenshot for a presentation using screenshot_url.

## Benefits

- Stop manual Print to PDF workflows by using convert_url_to_pdf to grab web content instantly.
- Automate report generation by turning raw HTML or Markdown into documents with convert_html_to_pdf.
- Handle bulk file management by merging or splitting documents with merge_pdfs and split_pdf.
- Keep files professional by updating metadata or bookmarks using write_pdf_metadata and write_pdf_bookmarks.
- Save time on content creation by converting Office files with convert_office_to_pdf instead of manual saving.
- Create visual assets quickly by taking screenshots of web pages or code with screenshot_url and screenshot_html.

## How It Works

The bottom line is you get a programmatic way to handle document conversions and PDF edits without touching a single file manually.

1. Subscribe to the Gotenberg MCP and provide your instance URL
2. Connect your AI client to the Vinkius catalog
3. Ask your agent to convert, merge, or edit documents using natural language

## Frequently Asked Questions

**Can Gotenberg convert Word files to PDF?**
Yes, it can turn Word, Excel, and PowerPoint files into PDFs using LibreOffice integration.

**Can I use it to merge multiple PDFs?**
Yes, you can use it to combine several PDF files into one single document easily.

**Does it support converting live websites to PDFs?**
Yes, it can take a live URL and turn it into a high-quality PDF document.

**Can I edit the metadata of a PDF?**
Yes, you can read and write metadata, manage bookmarks, and even embed attachments in PDFs.

**Can it take screenshots of web pages?**
Yes, it can capture a screenshot of a live URL or raw HTML as an image file.

**Is there a way to split a large PDF into smaller files?**
Yes, it can split a PDF and provide the resulting files in a ZIP folder for you.

**Can I convert a live website to a PDF with specific margins?**
Yes! Use the `convert_url_to_pdf` tool. You can provide the URL and optional parameters like `marginTop`, `marginBottom`, `marginLeft`, and `marginRight` to customize the output.

**Is it possible to merge multiple PDF files into one?**
Absolutely. The `merge_pdfs` tool allows you to combine multiple PDF documents into a single file efficiently.

**Can I take a screenshot of a webpage instead of a PDF?**
Yes, you can use `screenshot_url` for live websites or `screenshot_html` for raw HTML content. You can even specify the format (png, jpeg, webp) and viewport dimensions.