Connect Craftmypdf to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the add text to pdf tool in Craftmypdf
Use the generate image tool in Craftmypdf
Use the update template tool in Craftmypdf
Use the get pdf info tool in Craftmypdf
Use the generate pdf (async) tool in Craftmypdf
Use the generate pdf tool in Craftmypdf
Supported Tools
add_text_to_pdf
Add Text to PDF
Annotate an existing PDF with dynamic text overlays. Add page numbers, headers, footers, or any custom text at configurable positions on selected pages.
Supports template variables like `{{pageNumber}}`, `{{totalPages}}`, and `{{currentIndex}}` within text.
generate_image
Generate Image
Generate a JPEG or PNG image from a CraftMyPDF template populated with JSON data. Uses the same template system as PDF generation but outputs an image file.
update_template
Update Template
Update an existing CraftMyPDF template's name or sample JSON data.
get_pdf_info
Get PDF Info
Retrieve PDF page count and document metadata. Page dimensions and form fields are included only when returned by the provider.
generate_pdf_async
Generate PDF (Async)
Initiate asynchronous PDF generation. The request returns immediately with a transaction reference. Once the PDF is ready, the result is delivered to the specified webhook URL.
Use this for large or batch PDF generation tasks where you don't need the result immediately.
generate_pdf
Generate PDF
Generate a downloadable PDF document by combining a pre-defined template with JSON data.
Supports password protection, configurable PDF standards, image resampling, and custom expiration times.
You can also load data from an external URL instead of passing it inline.
fill_pdf_fields
Fill PDF Form Fields
Fill in fillable form fields in an existing PDF document. Supports text boxes, checkboxes, dropdown menus, and other standard PDF form components. Optionally lock fields as read-only after filling.
get_template
Get Template
Retrieve detailed information about a specific CraftMyPDF template, including its structure, sample JSON data, and metadata. Optionally retrieve a specific version.
list_transactions
List Transactions
List PDF generation transactions for tracking and auditing, including credits consumed, transaction type, execution time, and response status.
get_account_info
Get Account Info
Retrieve the connected CraftMyPDF account username, quota counters, template limits, and creation date. Additional account details are included when available.
create_template
Create Template
Create a new PDF template by cloning an existing one. The new template will be a copy of the source template that can be independently modified.
list_templates
List Templates
Retrieve all available PDF templates from your CraftMyPDF account. Supports pagination and filtering by group name.
delete_template
Delete Template
Permanently delete a CraftMyPDF template. This action cannot be undone.
merge_pdfs
Merge PDFs
Merge multiple PDFs into a single document. Supports two modes:
- **By URL**: Combine existing PDF files by providing their URLs.
- **By Template**: Generate PDFs from multiple templates with their own data and merge them into one document.
Use "pdfUrls" for URL-based merging, or "templates" for template-based merging.
add_watermark
Add Watermark
Add a text watermark to an existing PDF document. Configure font size, opacity, rotation angle, color, and font family for the watermark overlay.
create_editor_session
Create Editor Session
Create a white-label editor session for embedding the CraftMyPDF template editor in an iframe. Returns a unique URL that can be embedded in your application.
Configure permissions to control what the user can do in the embedded editor (save, generate PDF, preview, edit JSON, etc.).
deactivate_editor_session
Deactivate Editor Session
Revoke an embedded template editor session using the session token returned when it was created.
list_template_versions
List Template Versions
List the available versions of a template to choose a version for generation, retrieval, or cloning. Version zero represents the latest version.
Enable Craftmypdf in Metorial. In your Metorial portal, enable the Craftmypdf MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Craftmypdf tools.
Enable Craftmypdf in Metorial. In your Metorial portal, enable the Craftmypdf MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Craftmypdf tools.
Enable Craftmypdf in Metorial. In your Metorial portal, enable the Craftmypdf MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Craftmypdf tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Craftmypdf in Metorial. In your Metorial portal, enable the Craftmypdf MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Craftmypdf tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Craftmypdf in Metorial. In your Metorial portal, enable the Craftmypdf MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Craftmypdf tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Craftmypdf through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Craftmypdf and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Craftmypdf tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Generate PDF documents and images (JPEG/PNG) from reusable templates and JSON data. Create PDFs synchronously or asynchronously with webhook callbacks. Merge multiple templates or PDF URLs into a single document. Add watermarks to existing PDFs. Manage PDF templates programmatically—list, create, update, and delete templates. Generate fillable PDF forms with text boxes, checkboxes, dropdowns, radio buttons, and signature fields. Configure output options including password protection, CMYK color profiles, PDF standards (PDF/A), and cloud storage integration. Create embeddable editor sessions for white-label template editing. Retrieve account details and transaction history.
Frequently asked questions
Common questions about connecting Craftmypdf to AI agents with Metorial.
How many tools does the Craftmypdf MCP server have?
The Craftmypdf MCP server exposes 18 tools, including Add Text to PDF, Generate Image, Update Template. Each one is governed and traced through Metorial.
Does the Craftmypdf MCP server support triggers?
Craftmypdf exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Craftmypdf MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Craftmypdf MCP server through the same Metorial URL.
How do I give only some teams access to Craftmypdf?
Use role-based access control to decide which teams, users, and agents can use Craftmypdf and which of its tools they can call.
Can I self-host the Craftmypdf MCP server?
Yes. Metorial is open source, so you can run the Craftmypdf MCP server yourself or use the hosted gateway.
Connect Craftmypdf to production AI agents
See how Metorial gives your team governed access to Craftmypdf, with tracing and security controls built in.