KosmoKrator

files

CloudConvert MCP Integration for Claude Agent SDK

Connect CloudConvert to Claude Agent SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 5 read 2 write API key auth

Connect CloudConvert to Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

CloudConvert MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "mcpServers": {
    "kosmokrator-cloudconvert": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=cloudconvert",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=cloudconvert --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only CloudConvert instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

CloudConvert Tools Visible to Claude Agent SDK

Claude Agent SDK sees stable MCP tool names generated from the CloudConvert integration catalog.

MCP toolSource functionTypeDescription
integration__cloudconvert__cloudconvert_create_job cloudconvert.cloudconvert_create_job Write Create a new CloudConvert job. A job groups one or more tasks (import, convert, export) into a single workflow. Pass a tasks array to define the conversion pipeline.
integration__cloudconvert__cloudconvert_get_job cloudconvert.cloudconvert_get_job Read Get details and status of a CloudConvert job by ID, including all associated tasks and their results.
integration__cloudconvert__cloudconvert_list_jobs cloudconvert.cloudconvert_list_jobs Read List CloudConvert jobs with optional filtering by status or tag, and pagination.
integration__cloudconvert__cloudconvert_create_task cloudconvert.cloudconvert_create_task Write Create a standalone CloudConvert task. Specify an operation (e.g., import/url, convert, export/url, capture-website, merge, optimize, thumbnail) and the operation-specific payload.
integration__cloudconvert__cloudconvert_get_task cloudconvert.cloudconvert_get_task Read Get details and status of a CloudConvert task by ID, including the result payload with download URLs for completed conversions.
integration__cloudconvert__cloudconvert_list_tasks cloudconvert.cloudconvert_list_tasks Read List CloudConvert tasks with optional filtering by status, operation, or job ID, and pagination.
integration__cloudconvert__cloudconvert_get_current_user cloudconvert.cloudconvert_get_current_user Read Get the authenticated CloudConvert user profile, including remaining credits and subscription info.

Related CloudConvert Pages