Scrptly Ai Video Agent

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.

Input Parameters:

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

Output Parameters:

• 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.