Check Configuration

Immutable Catalog Entry

This descriptor comes from the active versioned Portal catalog.

READffmpeg.check_configuration

• Contract tier: agent_ready
• Risk: read
• Catalog version: 2026-07-12.3
• Descriptor hash: f7aa1c470c0e5031f97fd51371cd5c929e511ed4b716790654efe1fedb20ff5e

Use this before media work to verify that FFmpeg, storage, queue, signing, and optional export integrations are configured. It reads configuration presence only, contacts no provider, and never returns credential values.

Request Body

{
  "jsonrpc": "2.0",
  "id": "ffmpeg-check-configuration-example",
  "method": "tools/call",
  "params": {
    "name": "ffmpeg.check_configuration",
    "arguments": {}
  }
}

Arguments Schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Output Schema

{
  "type": "object",
  "required": [
    "ok",
    "serviceId",
    "required",
    "optional",
    "missing"
  ],
  "properties": {
    "ok": {
      "type": "boolean",
      "description": "Whether required FFmpeg service configuration is ready."
    },
    "missing": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Names of missing required settings."
    },
    "optional": {
      "type": "object",
      "description": "Optional integration configuration presence booleans only.",
      "additionalProperties": true
    },
    "required": {
      "type": "object",
      "description": "Required configuration presence booleans only.",
      "additionalProperties": true
    },
    "serviceId": {
      "type": "string",
      "description": "Canonical provider service ID."
    }
  },
  "additionalProperties": false
}

Code Examples

cURL

curl -X POST 'https://portal.madpanda3d.com/api/mcp' \
  -H 'Authorization: Bearer mad_live_***' \
  -H 'Content-Type: application/json' \
  -d '{
  "jsonrpc": "2.0",
  "id": "ffmpeg-check-configuration-example",
  "method": "tools/call",
  "params": {
    "name": "ffmpeg.check_configuration",
    "arguments": {}
  }
}'

Node.js

const response = await fetch('https://portal.madpanda3d.com/api/mcp', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer mad_live_***',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "jsonrpc": "2.0",
  "id": "ffmpeg-check-configuration-example",
  "method": "tools/call",
  "params": {
    "name": "ffmpeg.check_configuration",
    "arguments": {}
  }
}),
});
const data = await response.json();
console.log(data);

Python

import requests

url = 'https://portal.madpanda3d.com/api/mcp'
headers = {
    'Authorization': 'Bearer mad_live_***',
    'Content-Type': 'application/json',
}
payload = {
  "jsonrpc": "2.0",
  "id": "ffmpeg-check-configuration-example",
  "method": "tools/call",
  "params": {
    "name": "ffmpeg.check_configuration",
    "arguments": {}
  }
}
response = requests.post(url, headers=headers, json=payload, timeout=60)
print(response.json())

Example Responses

200 Success

{
  "ok": true,
  "message": "Tool ffmpeg.check_configuration executed successfully.",
  "note": "Response shape varies by MCP tool. Inspect live responses for exact fields."
}

502 Upstream Error

{
  "ok": false,
  "classification": "upstream_http_error",
  "message": "Upstream MCP returned a non-success status."
}