Carbone

Name: Carbone
Author: carboneio

@carboneio

关于 Carbone

Document generation & automation: generate invoices, contracts, reports, and any structured document from a DOCX/XLSX/PPTX/HTML/Markdown template + JSON data. Convert 100+ formats (Office, HTML, Markdown → PDF) with the PDF engines of your choice. Batch-generate hundreds of PDFs

#document #reporting #generation #automation #conversion #nocode #pdf #docx #xlsx #pptx #markdown #html

基本信息

分类

文件与存储

传输方式

stdio

发布者

carboneio

提交者

Steeve Payraudeau

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "carbone": {
      "type": "streamable-http",
      "url": "https://mcp.carbone.io",
      "headers": {
        "Authorization": "Bearer your_api_key_here"
      }
    }
  }
}

工具

List stored Carbone templates with filtering, search, and pagination. Filter by Template ID, Version ID, category, or upload origin. Use includeVersions to see the full version history of each template. Supports cursor-based pagination for large collections. Note: filtering by tags is not supported by the Carbone API — use list_tags to discover tags, then filter results manually.

Convert any document to another format without storing a template. Supports 100+ input/output format combinations: Office documents, PDFs, images, web pages, spreadsheets, and more. The source file can be a local path, a URL, or a base64 string. Use render_document instead when you need data injection ({d.field} tags), translations, or batch generation. Common conversions: DOCX → PDF (file: "report.docx", convertTo: "pdf"), XLSX → PDF (file: "data.xlsx", convertTo: "pdf"), PPTX → PDF (file: "slides.pptx", convertTo: "pdf", converter: "O" for best fidelity), HTML → PDF (file: "page.html", convertTo: "pdf", converter: "C" for full CSS/JS rendering), DOCX → HTML (file: "doc.docx", convertTo: "html"), XLSX → CSV (file: "sheet.xlsx", convertTo: "csv"), PDF → PNG (file: "doc.pdf", convertTo: "png"), PPTX → PNG (first slide as image), MD → PDF (file: "readme.md", convertTo: "pdf").

Generate a document by merging a Carbone template with JSON data. Two modes: (1) pass templateId to use a previously uploaded template; (2) pass template (file path, URL, or base64) to upload and render in a single request without storing a template. Supports output format conversion, multilingual rendering, currency conversion, batch generation, and advanced PDF options (watermark, password, PDF/A).

List all template categories currently in use in your Carbone account. Categories act like folders for organising templates (e.g. "invoices", "legal", "hr"). Use the returned names as the category filter in list_templates or upload_template.

List all tags currently used across templates in your Carbone account. Tags are free-form labels attached to templates (e.g. "sales", "billing", "v2"). Note: the Carbone API does not support filtering list_templates by tag — use this tool to discover available tags, then call list_templates and filter the results manually.

Upload and store a reusable Carbone template. Once uploaded, use render_document with the returned Template ID to generate documents from it. Supports versioning: multiple versions can live under a single stable Template ID, with deployedAt controlling which version is active. Accepted formats: DOCX, XLSX, PPTX, ODT, ODS, ODP, ODG, HTML, XHTML, IDML, XML, Markdown, PDF, and more.

Update the metadata of a stored template: name, comment, category, tags, deployment timestamp, or expiration. Use deployedAt to activate a specific version for rendering. Use expireAt to schedule or trigger immediate deletion.

Delete a stored Carbone template. This is a soft delete: the template is marked for garbage collection and removed after a delay (default 24 hours). You can delete by Template ID (removes all versions) or by Version ID (removes only that specific version). For immediate or scheduled deletion, use update_template_metadata with expireAt = 42000000000 (NOW) or a future Unix timestamp.

Download the original source file of a stored Carbone template (e.g. the DOCX, XLSX, PPTX, or HTML file that was uploaded). Use this to inspect, edit, or back up a template. Pass a Template ID to download the currently deployed version, or a Version ID to download a specific version.

Check Carbone API health and version. Returns the current API version and a status message. Useful for verifying connectivity and confirming which Carbone version is active.

Returns a summary of all Carbone capabilities: supported formats, features, tool usage examples, and links to full documentation. Call this first if you are unsure what Carbone can do.

概览

What is Carbone?

Carbone is a universal document automation MCP server that generates invoices, contracts, reports, certificates, tickets, and any structured document from a template plus JSON data, then delivers it as PDF, DOCX, XLSX, PPTX, or 100+ other formats. It also converts documents between 100+ formats and supports batch generation, multilingual/currency output, and advanced PDF options.

How to use Carbone?

Describe what you want in natural language — the AI handles the rest. Use tools like render_document, convert_document, upload_template, list_templates, and others. Provide template ID and JSON data, or a file URL for one-shot renders. For batch generation, split by an array in JSON and receive a ZIP archive.

Key features of Carbone

Generate documents from templates (Word, Excel, HTML, Markdown, etc.)
Convert documents between 100+ formats
Batch generate hundreds of documents in a single request
Multilingual and multi-currency output with translation tags and locale codes
Advanced PDF options: password protection, watermarks, PDF/A compliance
Template management with versioning, categories, tags, and deployment

Use cases of Carbone

Generate invoices, contracts, NDAs, and payslips from templates
Convert Office documents (DOCX, XLSX, PPTX) to PDF for archiving
Create one invoice PDF per client from billing data and bundle in ZIP
Render the same contract in multiple languages with currency conversion
Apply watermarks and password protection to final PDFs

FAQ from Carbone

What template formats does Carbone support?

Supported template formats include DOCX, XLSX, PPTX, ODT, ODS, ODP, HTML, Markdown, CSV, XML, IDML, and PDF (form filling).

Can I convert files without a stored template?

Yes, you can pass a file via local path, URL, or base64 and get the converted output instantly using the convert_document tool or one-shot render from a URL.

Does Carbone support batch generation?

Yes, you can generate hundreds of documents in a single request by splitting on any array in your JSON data, receiving all files as a ZIP archive.

What output formats are available for document generation?

Output can be delivered as PDF, DOCX, XLSX, PPTX, or 100+ other formats depending on the template and conversion options.

How does template versioning work?

You can store, version, categorise, tag, and deploy templates with full version history, then reuse them across any number of renders via a stable Template ID.