Add AI Video Generation to Claude Code with MCP in 5 Minutes

What is MCP and why it matters

The Model Context Protocol is an open standard that lets AI assistants interact with external tools and services. Instead of copying commands back and forth between your terminal and chat interface, MCP creates a direct bridge. Claude Code discovers the tools your MCP server exposes, understands what they do, and calls them autonomously when appropriate. For agent-media, this means Claude can submit video generations, check job status, list available models, and verify your credit balance — all through natural language conversation.

What you get after setup

Once connected, Claude Code gains access to all agent-media capabilities as MCP tools. Here is what becomes available:

• +Generate videos — ask Claude to create a video with any supported model (Kling, Sora, Seedance, Veo) and it submits the job for you
• +Generate images — request images from Flux 2 Pro, Flux 2 Flex, or Grok Imagine
• +Check job status — ask "is my video done?" and Claude queries the API for you
• +List models — ask which models are available and their capabilities
• +Check credits — verify your balance before starting expensive generations

Step 1: Install agent-media CLI

If you have not already installed the CLI, do that first. The MCP server is built into the CLI package — there is nothing extra to install.

Step 2: Add the MCP server configuration

Claude Code reads MCP server configurations from a settings file. You need to add an entry that tells Claude how to start the agent-media MCP server. Add the following to your Claude Code MCP settings:

{
  "mcpServers": {
    "agent-media": {
      "command": "npx",
      "args": ["-y", "agent-media-cli", "mcp-server"]
    }
  }
}

The npx -y flag ensures the package is available without prompting. When Claude Code starts, it launches the MCP server process and discovers all available tools automatically. You can also use the global install directly:

{
  "mcpServers": {
    "agent-media": {
      "command": "agent-media",
      "args": ["mcp-server"]
    }
  }
}

Step 3: Authenticate your account

The MCP server uses the same device key as the CLI. If you have already run agent-media login before, you are all set. If not, run it now:

The device key is stored locally and the MCP server reads it automatically. You do not need to pass any credentials to Claude Code or set environment variables.

Step 4: Try it out

Restart Claude Code to pick up the new MCP configuration. Then just ask Claude to generate something. Here are some example prompts to try:

How it works under the hood

When Claude Code starts with the agent-media MCP server configured, the following happens:

1. 1Claude Code launches the MCP server process using the configured command (agent-media mcp-server).
2. 2The server responds with a list of available tools: generate, check-status, list-models, and credits-check.
3. 3When you ask Claude to generate media, it identifies the appropriate tool, constructs the parameters (model, prompt, duration, aspect ratio), and sends a tool call through the MCP protocol.
4. 4The MCP server executes the command against the agent-media API using your stored device key and returns the result to Claude.
5. 5Claude formats the result (job ID, output URL, credit balance) and presents it in the conversation.

The entire flow happens within your existing Claude Code session. No browser tabs, no terminal switching, no context loss.

Use cases for MCP integration

The combination of Claude Code and agent-media opens up workflows that neither tool provides alone:

Available MCP tools reference

Here is the complete list of tools that the agent-media MCP server exposes to Claude Code:

Troubleshooting

If the MCP tools do not appear in Claude Code, check these common issues:

• *Not logged in: Run agent-media login before starting Claude Code. The MCP server needs a valid device key.
• *CLI not found: Ensure agent-media-cli is installed globally or that npx can resolve it. Test with agent-media --version.
• *Config not picked up: Restart Claude Code after adding the MCP configuration. Changes to settings require a fresh session.
• *Insufficient credits: The MCP server will return an error if you do not have enough credits. Check your balance with agent-media credits or ask Claude to check for you.