Shotstack MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Shotstack MCP or direct API to generate dynamic videos, create branded images, automate audio clips, and manage creative assets through natural language.

Shotstack logoShotstack
Api Key

Shotstack is a cloud platform for programmatically generating videos, images, and audio. Automate creative content production at scale with flexible RESTful APIs.

23 Tools

Try Shotstack now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Shotstack
Try asking
TOOLS

Supported Tools

Every Shotstack action and event your agent gets out of the box.

Create Template

Create a named Shotstack template from timeline and output settings for reuse in media editing and rendering.

Create Template (v2)

Tool to save an Edit as a re-usable template.

Delete Ingested Media

Delete an ingested source file from the production Ingest API by its ingest ID.

Delete Template

Delete a Shotstack template by ID in the stage environment.

Delete Shotstack Workflow

Tool to delete a specific Shotstack workflow.

Fetch Source

Queue a remote media file for ingestion as a source asset in the production Ingest API.

Get Asset

Retrieve details of a hosted asset by asset ID in the Shotstack staging environment, including videos, images, audio files, thumbnails, and poster images.

Get Assets by Render ID

Retrieve hosted assets by render ID in the Shotstack staging environment, including files such as video, thumbnail, and poster images.

Get Render Callback

Request callback details for a specific render job, including the callback URL and delivery status, attempts, response and last-attempt time.

Get Render Status

Retrieve the status and details of a Shotstack render job by render ID in the selected environment.

Get Source Details

Retrieve details and status of a source asset by ID from the production Ingest API.

Get Template

Retrieve a template's details and metadata by ID from the Shotstack staging environment.

Get Template By Version

Tool to retrieve a template by template id and API version.

Get Upload URL

Tool to request a signed URL for direct file upload to Shotstack.

Inspect Media

Tool to inspect media metadata.

List Sources

Request a list of ingested source assets from the production Ingest API, with optional pagination parameters.

List Sources (with Environment)

Tool to list all ingested source files with environment selection.

List Templates

List Shotstack templates for the account in the stage environment.

List Templates with Environment

Tool to list all Shotstack templates for the specified environment.

Request Upload URL

Request a signed URL for direct file upload to the Shotstack staging environment.

Render Video

Tool to initiate a new video render job.

Transfer Asset

Transfer a file from a publicly available URL to one or more production Serve API destinations, including Shotstack hosting or other configured destinations.

Update Template

Update a stage-environment template by ID, providing both its name and complete edit configuration.

SETUP GUIDE

Connect Shotstack MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["shotstack"],
  mcp: true,
});
Create a session scoped to Shotstack and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Create a 30-second promo video using product images and a background track",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Shotstack request
SETUP GUIDE

Connect Shotstack API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["shotstack"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Shotstack
3

Run Shotstack tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Create a 30-second promo video using product images and a background track" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Shotstack tool calls through the session, and print the final answer

Why Use Composio?

AI Native Shotstack Integration

  • Supports both Shotstack MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Shotstack data

Managed Auth

  • Built-in API key handling with secure storage and rotation
  • Central place to manage, scope, and revoke Shotstack access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Shotstack
  • Scoped, least privilege access to Shotstack resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Shotstack.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Shotstack tool your agent needs.Free to start.

Start building