gen-mcp-server 0.1.2

GEN MCP server — exposes the GEN platform (Auto Content Engine + agent chat) to MCP clients like Claude Code, Cursor, and VS Code.

gen-mcp-server

MCP server for the GEN platform — exposes the GEN Auto Content Engine + agent chat to MCP clients (Claude Code, Cursor, VS Code).

It mirrors what a user can do through the GEN front end: set up agents, build vidsheets, generate images (incl. Nano Banana Pro), video, songs, voice, render, create song-mix jobs, schedule/publish, manage credits, and run daily tasks. The gen_do tool delegates natural-language goals to the GEN composer for multi-step outcomes.

Generation tools

• gen_create_image — image generation, including Nano Banana Pro
• gen_create_video — one video clip from a prompt
• gen_create_song — ACE-Step song generation via fal.ai; supports fal-ai/ace-step and fal-ai/ace-step/prompt-to-audio, defaults to 240 seconds, maxes at 240 seconds, and accepts an optional HTTPS reference audio URL
• gen_create_song_mix — create a soundtrack mix job for an existing project
• gen_get_generation — poll any generation job

Install

pip install gen-mcp-server      # or: uvx gen-mcp-server

Configure (Claude Code)

claude mcp add gen --env GEN_API_KEY=your-pat -- gen-mcp-server

Get a Personal Access Token at https://gen.pro (log in → pick an agent → API page).

Environment

• GEN_API_KEY (required) — your Personal Access Token
• GEN_API_BASE_URL (default https://api.gen.pro/v1)
• GEN_AGENT_API_URL (default https://agent.gen.pro/v1)
• GEN_AGENT_CORE_API_URL (default https://agent-core.gen.pro/v1)

Errors & credits

Backend errors are surfaced cleanly. If you run out of credits, tools return insufficient_credits: true with a message pointing to gen_buy_credits.