Metadata-Version: 2.4
Name: gen-mcp-server
Version: 0.1.3
Summary: GEN MCP server — exposes the GEN platform (Auto Content Engine + agent chat) to MCP clients like Claude Code, Cursor, and VS Code.
Project-URL: Homepage, https://api.gen.pro
Project-URL: Repository, https://github.com/poweredbyGEN/gen-agentic
Author: GEN
License: MIT
Keywords: ai,content,gen,gen-pro,mcp,video
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Description-Content-Type: text/markdown

# 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

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

## Configure (Claude Code)

```bash
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`.
