How to Use the Gotenberg MCP in Cursor

Q: Will Gotenberg in Cursor handle large PDF merges?

Yes, the mergepdfs tool is designed to handle multiple inputs efficiently. You can define the order in your prompt, and the agent will execute the merge.

Use Gotenberg in Cursor to automate PDF generation and document editing while you write code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Gotenberg MCP to Cursor

Create your Vinkius account to connect Gotenberg to Cursor — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Gotenberg with Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Convert Assets to PDF in Cursor

Convert your project's Markdown documentation or HTML prototypes to PDF using `convert_markdown_to_pdf` or `convert_html_to_pdf`. You can trigger these directly from the chat panel while coding. This keeps your documentation pipeline right next to your source code. Your agent handles the conversion, so you stay focused on the implementation.

Edit PDF Metadata Programmatically

Update author tags, titles, and bookmarks on generated PDFs using `write_pdf_metadata` and `write_pdf_bookmarks`. This is useful for CI/CD pipelines where you need standardized document headers. Run these tools in Agent mode to automatically tag your reports before they get pushed to production. It removes manual cleanup steps from your build process.

Manage Office Documents via Gotenberg

Handle legacy Office files by using `convert_office_to_pdf` to turn them into standardized PDFs. It's a reliable way to normalize document formats across your project. The tool integrates with the underlying engine to ensure your layout remains intact. You get a clean PDF ready for distribution without needing external software.

Setup guide

Set up Gotenberg MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Gotenberg MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Gotenberg transactions." If the MCP tools are loaded correctly, Cursor will call the Gotenberg tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "gotenberg-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 Gotenberg. 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 Gotenberg 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 Gotenberg MCP in Cursor

Create an mcp.json file in your project root or global config directory. Define the server path under mcpServers, and Cursor will load the tools into your agent context.

Yes, you can point the tools at your local dev server URL. Use `convert_url_to_pdf` to capture your dynamic application views as high-fidelity documents.

You control the server instance, so you decide where the data is processed. Running it locally means your source code and generated documents never leave your machine.

Yes, the `merge_pdfs` tool is designed to handle multiple inputs efficiently. You can define the order in your prompt, and the agent will execute the merge.

The server only touches the files you explicitly provide to the tools. It performs its operations in isolation, and no trace of your document content is kept after the session ends.

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