# Carbone — MCP server on mcp.ai
> Connect your Carbone account and use 11 tools for documents straight from your AI agent. Connect with your own API key. Carbone is a fast and simple report generator that converts JSON data into various document formats such as PDF, DOCX, XLSX, ODT, and more, using templates.

By: mcp.ai · official
Page: https://mcp.ai/carbone

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_carbone?ms=1787296080000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/carbone/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/carbone/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/carbone/skill.md
Postman collection (v2.1): https://mcp.ai/carbone/postman.json

## Tools
- carbone_delete_template(templateId: string) — Permanently delete a template from the Carbone server by its 64-character hexadecimal template ID. This action is irreversible. Ensure you have the correct template ID before deleting.
- carbone_download_template(template_id: string) — Tool to download a template from Carbone by template ID. Use when you need to retrieve the original template file.
- carbone_generate_report(data: object|object[], enum?: object, lang?: string, timezone?: string, convertTo?: string|object, complement?: object, reportName?: string, templateId: string, batchOutput?: string, hardRefresh?: boolean, variableStr?: string, batchSplitBy?: string, translations?: object, currencyRates?: object, currencySource?: string, currencyTarget?: string, carbone-webhook-url?: string, carbone-webhook-headers?: object) — Tool to generate a Carbone report from a template and JSON data. Use when you need to render documents in various formats.
- carbone_get_status() — Tool to retrieve the current status and health of the Carbone server. Use before generating reports to ensure the service is operational.
- carbone_list_template_categories(carbone_version?: integer) — Tool to retrieve a list of all categories used in templates. Categories function like folders for organizing templates. Use when you need to see available template groupings.
- carbone_list_template_tags(carbone_version?: integer) — Tool to list all tags currently used in templates. Use when you need to discover available tags for categorizing or filtering templates by document type or version.
- carbone_list_templates(id?: string, limit?: integer, cursor?: string, origin?: integer, search?: string, category?: string, versionId?: string, carbone_version?: integer, includeVersions?: boolean) — Tool to retrieve a list of templates from Carbone storage with filtering, search, and cursor-based pagination. Use when you need to find templates, search by name or ID, or iterate through all deploye
- carbone_render_template_direct(data: object|object[], enum?: object, lang?: string, download?: boolean, template: string, timezone?: string, convertTo?: string|object, complement?: object, reportName?: string, batchOutput?: string, hardRefresh?: boolean, variableStr?: string, batchSplitBy?: string, translations?: object, currencyRates?: object, currencySource?: string, currencyTarget?: string, carbone-version?: string) — Tool to generate a document by uploading a base64-encoded template and data in a single API call. Use when you need to render documents without uploading templates separately.
- carbone_set_api_version(version: integer) — Tool to set the Carbone API version to be used for subsequent requests. Use before rendering or managing templates to ensure correct version is applied.
- carbone_update_template(name?: string, tags?: string[], comment?: string, category?: string, expireAt?: integer, deployedAt?: integer, templateId: string, carbone_version?: integer) — Tool to update metadata and attributes of an existing Carbone template. Use when you need to modify template name, comment, tags, category, or control version deployment and lifecycle.
- carbone_upload_template(template: object|string) — Upload a template file to the Carbone server to obtain a template ID for document generation. Supported template formats: DOCX, XLSX, PPTX, ODT, ODS, ODP, ODG, XHTML, IDML, HTML, or XML. Templates can

## Example prompts
- "What can I do in Carbone?"
- "Show me a summary of my Carbone account"

## Links
Docs: https://mcp.ai/docs/mcps/carbone
Website: https://mcp.ai/mcps/carbone