{
  "info": {
    "name": "Shotstack — mcp.ai",
    "description": "REST API for the Shotstack 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/shotstack",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "shotstack_create_template",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/template",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "template"
          ]
        },
        "description": "Tool to create a new template for video editing. Use when you want to save a reusable timeline configuration as a template. Template changes do not retroactively affect past renders.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"output\": {},\n  \"template\": false,\n  \"timeline\": {},\n  \"description\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_create_template2",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/template2",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "template2"
          ]
        },
        "description": "Tool to save an Edit as a re-usable template. Templates can be retrieved and modified before rendering. Use when you want to create a template with merge fields for dynamic content.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"version\": \"\",\n  \"template\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_delete_ingested_media",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/ingested/media",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "ingested",
            "media"
          ]
        },
        "description": "Tool to delete an ingested media asset. Use when you've confirmed the ingest ID and need to remove the file from Shotstack storage.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_delete_template2",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/template2",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "template2"
          ]
        },
        "description": "Tool to delete a specific Shotstack template by its ID. Use when you need to remove a template permanently.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_delete_workflow",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/workflow",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "workflow"
          ]
        },
        "description": "Tool to delete a specific Shotstack workflow. Use when you need to permanently remove a workflow after confirming its ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"workflowId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_fetch_source",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/source",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "source"
          ]
        },
        "description": "Tool to fetch a remote media file and store it as a source asset. Operation is asynchronous — poll SHOTSTACK_GET_INGEST_STATUS or SHOTSTACK_INSPECT_MEDIA until the asset is ready before passing it to ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_get_assets",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/assets",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "assets"
          ]
        },
        "description": "Tool to fetch details of a hosted asset by its unique identifier. Use when you need to retrieve information about videos, images, audio files, thumbnails, or poster images hosted on Shotstack's CDN.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_get_assets_render",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/assets/render",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "assets",
            "render"
          ]
        },
        "description": "Tool to retrieve hosted assets by render ID. Use when you need to fetch one or more files (video, thumbnail, poster image) generated by a specific render job.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_get_ingest_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/ingest/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "ingest",
            "status"
          ]
        },
        "description": "DEPRECATED: Use SHOTSTACK_GET_SOURCE instead. Tool to retrieve the status and details of an ingested media asset. Poll until the asset status is 'ready' before using it in SHOTSTACK_RENDER_VIDEO; rend",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ingestId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_get_render_callback",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/render/callback",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "render",
            "callback"
          ]
        },
        "description": "Tool to retrieve the webhook/callback URL configuration for a specific render job. Returns only callback settings (URL, method, headers), not render status or output URLs — use a separate render-statu",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"renderId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_get_render_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/render/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "render",
            "status"
          ]
        },
        "description": "Tool to retrieve the current status and details of a Shotstack render job by render ID. Use when polling a render until done or failed, typically after creating a render with SHOTSTACK_RENDER_VIDEO.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"data\": false,\n  \"merged\": false,\n  \"version\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_get_source",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/source",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "source"
          ]
        },
        "description": "Tool to fetch the details of a specific source asset. Use when you need to inspect a source after uploading, check its status, or diagnose ingest/render failures—such as unsupported codecs, corrupt fi",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_get_template",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/template",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "template"
          ]
        },
        "description": "Tool to retrieve details of a specific template. Use when you have the ID of an existing template and need its metadata.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"templateId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_get_template_by_version",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/template/by/version",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "template",
            "by",
            "version"
          ]
        },
        "description": "Tool to retrieve a template by template id and API version. Use when you need to fetch template details from a specific Edit API version.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"version\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_get_upload_url",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/upload/url",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "upload",
            "url"
          ]
        },
        "description": "Tool to request a signed URL for direct file upload to Shotstack. Use when you need to upload a file to Shotstack storage. The response returns a signed URL that you use to upload the file using a PUT",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"version\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_inspect_media",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/inspect/media",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "inspect",
            "media"
          ]
        },
        "description": "Tool to inspect media metadata. Use before rendering to retrieve duration, resolution, frame rate, and format of an online media file — clip timecodes, trim points, and audio sync calculations depend ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_list_sources",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/sources",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "sources"
          ]
        },
        "description": "Tool to list all source assets. Use when you need to retrieve source entries with optional pagination.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"index\": \"\",\n  \"limit\": 0,\n  \"offset\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_list_sources2",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/sources2",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "sources2"
          ]
        },
        "description": "Tool to list all ingested source files with environment selection. Use when you need to retrieve sources from stage (sandbox) or v1 (production) environment with optional pagination.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\",\n  \"index\": \"\",\n  \"limit\": 0,\n  \"offset\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_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 list all Shotstack templates for the account. Use after creating or updating templates to view your available templates.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_list_templates2",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/templates2",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "templates2"
          ]
        },
        "description": "Tool to list all Shotstack templates for the specified environment. Use when you need to retrieve templates from a specific environment (stage or production).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"env\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_post_upload",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/post/upload",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "post",
            "upload"
          ]
        },
        "description": "Tool to request a signed URL for direct file upload. Use when you need to upload a file to Shotstack storage. The response returns a signed URL that expires in one hour.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_render_video",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/render/video",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "render",
            "video"
          ]
        },
        "description": "Tool to initiate a new video render job. Use when you have defined a timeline and output settings and want to start rendering.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"output\": {},\n  \"callback\": \"\",\n  \"timeline\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_transfer_asset",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/transfer/asset",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "transfer",
            "asset"
          ]
        },
        "description": "Tool to transfer a file from any publicly available URL to one or more Serve API destinations. Use when you need to copy a file from an external source to Shotstack's hosting service or other configur",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"url\": \"\",\n  \"destinations\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "shotstack_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 an existing template by its ID. Use when you need to modify a template's name or edit configuration. Both name and complete template definition must be provided.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"name\": \"\",\n  \"template\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}