Shotstack MCP server

Connect Shotstack to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Shotstack MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the render template tool in Shotstack
  • Use the get hosted asset tool in Shotstack
  • Use the transfer asset tool in Shotstack
  • Use the request upload url tool in Shotstack
  • Use the render video tool in Shotstack
  • Use the get assets by render tool in Shotstack

Supported Tools

render_template

Render Template

Render a previously saved template. Optionally provide merge field replacements to personalize the output. Use this for mass video personalization.

get_hosted_asset

Get Hosted Asset

Retrieve details of a hosted asset by its asset ID. Returns the CDN URL, status, and metadata. Assets are stored on Shotstack's CDN by default.

transfer_asset

Transfer Asset

Fetch a file from a public URL and distribute it to one or more hosting destinations. Supports Shotstack CDN, AWS S3, Mux, Google Cloud Storage, Google Drive, and Vimeo.

request_upload_url

Request Upload URL

Request a signed URL for direct file upload. Upload your file to the returned URL with a PUT request. Optionally specify renditions to apply after upload.

render_video

Render Video

Submit a video, image, or audio edit for rendering. Define a timeline with tracks, clips, transitions, effects, and filters. Supports output in MP4, GIF, JPG, PNG, BMP, and MP3 formats at various resolutions. Use merge fields to substitute dynamic values into the edit. Configure output destinations including Shotstack CDN, AWS S3, Mux, Google Cloud Storage, Google Drive, and Vimeo.

get_assets_by_render

Get Assets by Render

Look up all hosted assets for a render job (video, poster, thumbnail). Up to 3 assets may be returned per render.

generate_ai_asset

Generate AI Asset

Generate images, videos, speech, or text using built-in or third-party AI providers. **Built-in Shotstack providers:** - **text-to-speech**: Generate speech audio from text with multiple voices and languages. - **text-to-image**: Generate images from text prompts. - **image-to-video**: Convert still images into videos. - **text-generator**: Generate text content powered by GPT-4. **Third-party providers** (require API keys configured in the Shotstack dashboard): - **elevenlabs**: Realistic text-to-speech. - **d-id**: Talking avatar generation from text. - **stability-ai**: Image generation using Stable Diffusion engines. - **heygen**: Avatar video generation.

probe_media

Probe Media

Inspect a media file at a given URL and retrieve its metadata. Returns format, duration, codec, resolution, and other technical details. Useful for validating media before rendering.

get_template

Get Template

Retrieve a template's full details including the edit configuration. Use this to inspect or duplicate a template.

ingest_source

Ingest Source

Fetch and ingest a media file from a URL. Optionally apply transformations (renditions) like format conversion, resizing, and speed changes. The source is stored by Shotstack and can be used directly in edits.

list_sources

List Sources

List all ingested sources. Returns source IDs, status, and metadata.

delete_hosted_asset

Delete Hosted Asset

Permanently delete a hosted asset from the Shotstack CDN.

get_render

Get Render Status

Check the status and details of a render job. Returns the current status, output URL (when complete), poster and thumbnail URLs, and timing information.

create_template

Create Template

Save a reusable edit configuration as a template. Templates can include merge field placeholders for dynamic content substitution at render time.

update_template

Update Template

Update an existing template's name and/or edit configuration.

get_generated_asset

Get Generated Asset

Check the status of an AI-generated asset. When complete, returns the output URL for the generated image, video, speech, or text.

delete_source

Delete Source

Permanently delete an ingested source and its stored files.

delete_template

Delete Template

Permanently delete a saved template.

list_templates

List Templates

Retrieve a list of all saved templates. Returns template IDs, names, and timestamps.

get_source

Get Source

Retrieve details of an ingested source including status, dimensions, duration, rendition outputs, and transcription results.

generate_media

Generate Media

Generate a single image, video, or audio asset with the current Edit API. Discover models and their options first, then request quote_generation before submitting paid work.

quote_generation

Quote Generation

Estimate the credits for a media generation without creating a job or reserving credits. The price can change before submission.

list_generation_models

List Generation Models

Discover current generation model IDs, media types, account availability, and optionally option schemas.

get_generation

Get Generation

Check an Edit API generation job and prepare its completed media for download. This only retrieves an existing job.

get_generation_model

Get Generation Model

Get a model from list_generation_models, including its accepted settings as a JSON Schema.

Connect Shotstack to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Shotstack in Metorial. In your Metorial portal, enable the Shotstack MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Shotstack tools.

Run Shotstack through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Shotstack and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Shotstack tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Shotstack

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

Google Sheets

Create, read, and update spreadsheets and their cell data. Read and write values to individual cells, ranges, or multiple ranges using A1 notation or named ranges. Apply cell formatting including text styles, backgrounds, borders, number formats, and conditional formatting. Manage sheets (tabs) within a spreadsheet—add, delete, copy, rename, and reorder them. Create and manage embedded charts, pivot tables, filter views, data validation rules, protected ranges, named ranges, and merged cells. Perform batch operations to apply multiple updates atomically.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Technical notes for Shotstack

Programmatically edit and generate videos, images, and audio using a JSON-based timeline model. Arrange clips with transitions, effects, filters, and overlays. Create reusable templates with merge fields for mass video personalization. Ingest and transform source assets (resize, convert formats, adjust frame rates). Host and distribute rendered assets via CDN or to AWS S3, Google Cloud Storage, Google Drive, Mux, and Vimeo. Generate AI-powered assets including text-to-image, text-to-speech, image-to-video, text generation, talking avatars (D-ID), realistic voice synthesis (ElevenLabs), and Stable Diffusion image generation. Inspect media file metadata such as format, duration, and codecs.

Frequently asked questions

Common questions about connecting Shotstack to AI agents with Metorial.

  1. How many tools does the Shotstack MCP server have?
    The Shotstack MCP server exposes 25 tools, including Render Template, Get Hosted Asset, Transfer Asset. Each one is governed and traced through Metorial.
  2. Shotstack exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Shotstack MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Shotstack and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Shotstack MCP server yourself or use the hosted gateway.

Connect Shotstack to production AI agents

See how Metorial gives your team governed access to Shotstack, with tracing and security controls built in.