Connect Carbone 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 render document tool in Carbone
Use the upload template tool in Carbone
Use the update template tool in Carbone
Use the check status tool in Carbone
Use the download template tool in Carbone
Use the list templates tool in Carbone
Supported Tools
render_document
Render Document
Generate a document by merging a Carbone template with JSON data. Synchronous renders include a downloadable document and retain the render ID. For asynchronous renders, use download_document after the completion webhook. Supports output format conversion, locale/timezone settings, dynamic filenames, currency conversion, and batch generation.
upload_template
Upload Template
Upload a document template to Carbone for later use in document generation. The template must be provided as a **base64-encoded** string of a supported file type (DOCX, XLSX, PPTX, ODT, ODS, ODG, ODP, XHTML, IDML, HTML, XML). Optionally enable versioning, assign metadata (name, tags, category, comment), set a deployment timestamp, or configure expiration.
update_template
Update Template
Update metadata for an existing Carbone template. You can modify the name, comment, tags, category, deployment timestamp, or expiration timestamp without re-uploading the template file.
check_status
Check Status
Check if the Carbone API service is running and accessible. This endpoint does not require authentication.
download_template
Download Template
Download a stored Carbone template using its template ID or version ID. Use list_templates to discover template and version IDs.
list_templates
List Templates
Retrieve a list of templates stored in Carbone. Supports filtering by template ID, version ID, category, origin, and free-text search. Use cursor-based pagination for large result sets.
delete_template
Delete Template
Permanently delete a template from Carbone storage. Accepts either a template ID (deletes all versions) or a specific version ID.
list_categories_and_tags
List Categories and Tags
Retrieve all categories and tags currently used by your Carbone templates. Useful for discovering available template groupings and labels before filtering or uploading templates.
download_document
Download Document
Download a generated Carbone report using the render ID from render_document or a completion webhook.
Enable Carbone in Metorial. In your Metorial portal, enable the Carbone 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 Carbone tools.
Enable Carbone in Metorial. In your Metorial portal, enable the Carbone 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 Carbone tools.
Enable Carbone in Metorial. In your Metorial portal, enable the Carbone 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 Carbone tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Carbone in Metorial. In your Metorial portal, enable the Carbone 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 Carbone tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Carbone in Metorial. In your Metorial portal, enable the Carbone 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 Carbone tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Carbone through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Carbone and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Carbone tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Generate documents by merging JSON data into templates (DOCX, XLSX, PPTX, ODT, ODS, HTML, XML, and more). Upload, list, update, and delete reusable document templates with Carbone tags. Render documents in various output formats including PDF, DOCX, XLSX, CSV, and XML. Convert between document formats using LibreOffice, OnlyOffice, or Chromium engines. Generate batch documents as ZIP or merged PDF files. Support asynchronous rendering with webhook notifications. Manage template versioning, metadata, categories, and tags. Download generated documents via unique render IDs.
Frequently asked questions
Common questions about connecting Carbone to AI agents with Metorial.
How many tools does the Carbone MCP server have?
The Carbone MCP server exposes 9 tools, including Render Document, Upload Template, Update Template. Each one is governed and traced through Metorial.
Does the Carbone MCP server support triggers?
Carbone 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 Carbone MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Carbone MCP server through the same Metorial URL.
How do I give only some teams access to Carbone?
Use role-based access control to decide which teams, users, and agents can use Carbone and which of its tools they can call.
Can I self-host the Carbone MCP server?
Yes. Metorial is open source, so you can run the Carbone MCP server yourself or use the hosted gateway.
Connect Carbone to production AI agents
See how Metorial gives your team governed access to Carbone, with tracing and security controls built in.