Submit Job via MCP

POST

/mcp

Submit media conversion job via Model Context Protocol.

Same as /api/conversion but requires llmId field for tracking which LLM generated the request.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

Job submitted via MCP

Body

🟠400Bad Request

🟠401Unauthorized

🟠429Too Many Requests

Request Example

Shell

JavaScript

Java

Swift

cURL

Basic MCP ConversionMCP Slideshow Request

curl --location --request POST '/mcp' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "input": "/tmp/input.mp4",
    "output": "/tmp/output.mp4",
    "llmId": "claude-3-opus",
    "parameters": {
        "c:v": "libx264",
        "crf": "23"
    }
}'

Response Example

202 - Example 1

{
    "jobId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "PENDING",
    "message": "Job queued for processing"
}

Modified at 2025-11-17 21:28:22

Query Job Status

Health Check