KosmoKrator

files

CloudConvert MCP Integration for OpenAI Agents SDK

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

7 functions 5 read 2 write API key auth
Submit CloudConvert feedback View package source

Connect CloudConvert to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

CloudConvert MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "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 OpenAI Agents

OpenAI Agents 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

CloudConvert CLIUse direct JSON commands instead of MCP discovery. CloudConvert MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.