{
  "info": {
    "name": "Carbone — mcp.ai",
    "description": "REST API for the Carbone MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/carbone",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "carbone_delete_template",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/template",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "template"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"templateId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "carbone_download_template",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/download/template",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "download",
            "template"
          ]
        },
        "description": "Tool to download a template from Carbone by template ID. Use when you need to retrieve the original template file.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"template_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "carbone_generate_report",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/generate/report",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "generate",
            "report"
          ]
        },
        "description": "Tool to generate a Carbone report from a template and JSON data. Use when you need to render documents in various formats.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": \"\",\n  \"enum\": {},\n  \"lang\": \"\",\n  \"timezone\": \"\",\n  \"convertTo\": \"\",\n  \"complement\": {},\n  \"reportName\": \"\",\n  \"templateId\": \"\",\n  \"batchOutput\": \"\",\n  \"hardRefresh\": false,\n  \"variableStr\": \"\",\n  \"batchSplitBy\": \"\",\n  \"translations\": {},\n  \"currencyRates\": {},\n  \"currencySource\": \"\",\n  \"currencyTarget\": \"\",\n  \"carbone-webhook-url\": \"\",\n  \"carbone-webhook-headers\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "carbone_get_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "status"
          ]
        },
        "description": "Tool to retrieve the current status and health of the Carbone server. Use before generating reports to ensure the service is operational.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "carbone_list_template_categories",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/template/categories",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "template",
            "categories"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"carbone_version\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "carbone_list_template_tags",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/template/tags",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "template",
            "tags"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"carbone_version\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "carbone_list_templates",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/templates",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "templates"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"limit\": 0,\n  \"cursor\": \"\",\n  \"origin\": 0,\n  \"search\": \"\",\n  \"category\": \"\",\n  \"versionId\": \"\",\n  \"carbone_version\": 0,\n  \"includeVersions\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "carbone_render_template_direct",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/render/template/direct",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "render",
            "template",
            "direct"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": \"\",\n  \"enum\": {},\n  \"lang\": \"\",\n  \"download\": false,\n  \"template\": \"\",\n  \"timezone\": \"\",\n  \"convertTo\": \"\",\n  \"complement\": {},\n  \"reportName\": \"\",\n  \"batchOutput\": \"\",\n  \"hardRefresh\": false,\n  \"variableStr\": \"\",\n  \"batchSplitBy\": \"\",\n  \"translations\": {},\n  \"currencyRates\": {},\n  \"currencySource\": \"\",\n  \"currencyTarget\": \"\",\n  \"carbone-version\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "carbone_set_api_version",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/set/api/version",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "set",
            "api",
            "version"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"version\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "carbone_update_template",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/template",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "template"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"tags\": \"\",\n  \"comment\": \"\",\n  \"category\": \"\",\n  \"expireAt\": 0,\n  \"deployedAt\": 0,\n  \"templateId\": \"\",\n  \"carbone_version\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "carbone_upload_template",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/upload/template",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "upload",
            "template"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"template\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}