Package Exports

@agentmedia/mcp-server
@agentmedia/mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@agentmedia/mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@agent-media/mcp-server

MCP server for agent-media — generate UGC videos from Claude Code, Cursor, Windsurf, or any MCP-compatible client.

Setup

npm install -g @agent-media/mcp-server

Or run directly:

npx @agent-media/mcp-server

Configuration

Set your API key as an environment variable:

export AGENT_MEDIA_API_KEY=ma_your_key_here

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "agent-media": {
      "command": "npx",
      "args": ["@agent-media/mcp-server"],
      "env": {
        "AGENT_MEDIA_API_KEY": "ma_your_key_here"
      }
    }
  }
}

Cursor

Add to Cursor MCP settings with the same configuration.

Tools

create_video

Generate a UGC video from a script. Submits the job, polls until complete, returns the video URL.

Parameters: script, actor_slug, tone, style, music, target_duration, aspect_ratio, allow_broll, broll_images, and more.

list_actors

Browse available AI actors. Returns slugs, names, age, gender, nationality.

get_video_status

Check a generation job's status. Returns status, video URL, error message.

Environment Variables

Variable	Required	Default	Description
`AGENT_MEDIA_API_KEY`	Yes	—	Your API key (ma_xxx format)
`AGENT_MEDIA_API_URL`	No	`https://api-v2-production-2f24.up.railway.app`	API base URL