Scrptly Video Generator

official

An Ai Video Agent that can generate professional and complex videos with simple prompts and context images.

View on scrptly.com

What can you do with Scrptly Video Generator MCP?

  • Generate an AI video from a prompt — Ask your assistant to create a video by calling generateAiVideo with a detailed text prompt describing duration, style, and plot.
  • Generate a video with reference images — Include optional context image URLs and descriptions in generateAiVideo to guide the visual output.
  • Set a token budget for generation — Use the approveUpTo parameter in generateAiVideo to cap the cost of a video generation request.
  • Check video generation status — Poll getTaskStatus with a task ID to see if a video is awaiting, processing, completed, or failed.
  • Retrieve the finished video and project link — After a successful task, get the result video URL and a projectUrl for further editing on Scrptly.

Documentation

closeLoginsearchSearchSignup1,000

←Scrptly's MCP Server

The Scrptly MCP (Model Connector Protocol) Server allows you to connect Scrptly with your preferred Large Language Model (LLM) via the MCP interface. This enables you to leverage custom LLMs for generating professional videos through Scrptly's AI Agent.

Setting Up the MCP Server

You can connect Scrptly's MCP Server to your LLM of choice through this configuration:

  • Endpoint URL: https://mcp.scrptly.com/
  • Authentication: Use your Scrptly API key for authentication. The authentication method used is Bearer Token in the Authorization header.

For clients that require a JSON configuration, here is an example setup:

{
	"mcpServers": {
		"scrptly-video-generator": {
			"command": "npx",
			"args": ["mcp-remote", "https://mcp.scrptly.com/", "--header", "Authorization: Bearer YOUR_API_KEY_HERE"]
		}
	}
}

Using the MCP Server

Scrptly's MCP Server acts as a bridge between your LLM and Scrptly's AI Video-Agent. When you send requests to the MCP Server, it calls Scrptly's AI Video-Agent API to generate videos based on the prompts processed by your LLM.

Scrptly's MCP currently supports the following tool:

Generate AI Video — generateAiVideo

Generate a video based on a text prompt and optional context images.

Input Parameters:

  • prompt: [string] A detailed text prompt for generating the video. It should include the duration of the video, the visual style, the plot/content and anything relevant to generate a high quality video.
  • context : [array of objects] An optional array of context images to guide the video generation. Each image should have a URL and a brief description.
    • context[].url : [string] The URL of a context image to be used in the video generation.
    • context[].description : [string] A brief description of the context image and how it should be used in the video.
  • approveUpTo : [number] The maximum cost (in tokens) that the user approves for generating the video. Optional but highly recommended. Default is 10,000 tokens.

Output Parameters:

  • taskId: [string] The ID of the task created to generate the AI video.
  • projectId: [string] The ID of the AI video project created on Scrptly.
  • projectUrl: [string] The URL to view and manage/tweak the generated AI video project on Scrptly.

Get Task Status — getTaskStatus

Check the status of an AI video generation task.

  • taskId: [string] The ID of the AI video generation task to check the status for.

  • status: [string] The current status of the AI video generation task. Possible values are 'awaiting', 'processing', 'success', and 'failed'.

  • statusMessage: [string] A detailed message about the current status of the task.

  • resultVideoUrl: [string] The URL of the generated video file, if the task is completed successfully.

  • projectId: [string] The ID of the AI video project created on Scrptly.

  • projectUrl: [string] The URL to view and manage/tweak the generated AI video project on Scrptly.