←Scrptly's MCP Server

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.