Turbogen

Generate images, video and audio from your AI assistant: Seedance, Kling, Veo, Nano Banana Pro and more through one API key. Jobs are polled and files saved locally. Install: uvx turbogen-mcp

View on pypi.org

Documentation

turbogen-mcp 0.1.2

MCP server for Turbogen: Seedance, Kling, Veo, Nano Banana Pro and more - images, video and audio, pay-as-you-go

pip install turbogen-mcp

Turbogen MCP server

Generate images, video and audio with Turbogen straight from Claude Desktop, Claude Code, Cursor or any other MCP client. Same models and prices as the studio; credits come from your balance.

Tools

Tool	What it does
`list_models(kind?)`	Model ids, aspect/voice choices, options and credit prices (`kind` = image, video or audio)
`generate_image(prompt, model="nano-banana-2", aspect="1:1", option?, reference_images?)`	Image, saved locally; a preview is returned when the file is under 1 MB
`generate_video(prompt, model="veo-3.1-fast", aspect="16:9", option="8s", image_path?)`	Video clip; pass `image_path` for image-to-video
`generate_audio(text_or_prompt, model="voice", aspect?, option?, lyrics?)`	`voice` (aspect = voice name), `music` (aspect = Instrumental / With vocals + lyrics) or `sfx`
`upscale_image(path, scale="2x")`	Upscale a local image 2x or 4x
`get_balance()`	Remaining credits
`job_status(job_id, download=false)`	Status of a job, e.g. one that took longer than the 10-minute wait

Generation tools submit the job, poll every 5 s for up to 10 minutes (parallel jobs share one status request and wait out rate limits), download the result into the output folder and return the local path, the cost and your remaining credits.

Get an API key

API access comes with the Boost, Turbo and Max packs. Open API in the studio (https://turbogen.app/#/apikeys), create a key and copy it (lk_..., shown only once).

Configuration

Variable	Required	Default
`TURBOGEN_API_KEY`	yes	—
`TURBOGEN_BASE_URL`	no	`https://turbogen.app`
`TURBOGEN_OUTPUT_DIR`	no	`~/Downloads/turbogen`

Install

With uv nothing needs installing up front, uvx runs it on demand:

uvx turbogen-mcp

Or install the command once with pipx (or uv tool):

pipx install turbogen-mcp      # or: uv tool install turbogen-mcp
turbogen-mcp                            # waits for an MCP client on stdin; Ctrl+C to quit

Plain venv:

python -m venv .venv
.venv/bin/pip install turbogen-mcp     # Windows: .venv\Scripts\pip install turbogen-mcp

Requires Python 3.10+.

Claude Desktop

Edit claude_desktop_config.json (Settings > Developer > Edit Config; macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\) and restart Claude Desktop:

{
  "mcpServers": {
    "turbogen": {
      "command": "uvx",
      "args": ["turbogen-mcp"],
      "env": {
        "TURBOGEN_API_KEY": "lk_your_key_here"
      }
    }
  }
}

With pipx use "command": "turbogen-mcp" and drop args. If the app cannot find the command, give the full path (e.g. C:\\Users\\you\\.local\\bin\\turbogen-mcp.exe).

Claude Code

claude mcp add turbogen --env TURBOGEN_API_KEY=lk_your_key_here -- uvx turbogen-mcp
# installed with pipx instead:
claude mcp add turbogen --env TURBOGEN_API_KEY=lk_your_key_here -- turbogen-mcp

Add --scope user to make it available in every project. Check with claude mcp list.

Cursor

Create .cursor/mcp.json in the project (or ~/.cursor/mcp.json for all projects):

{
  "mcpServers": {
    "turbogen": {
      "command": "uvx",
      "args": ["turbogen-mcp"],
      "env": {
        "TURBOGEN_API_KEY": "lk_your_key_here",
        "TURBOGEN_OUTPUT_DIR": "~/Downloads/turbogen"
      }
    }
  }
}

Try it

Ask your assistant things like:

"List the Turbogen video models and their prices."
"Generate a 16:9 image of a lighthouse at dusk with nano-banana-2."
"Turn ~/Downloads/turbogen/lighthouse.png into an 8 second Veo clip with a slow push-in."
"Make a 5 second sound effect of waves on rocks."
"How many credits do I have left?"

Errors

Not enough credits (402): top up at <base>/#/pricing.
Invalid API key (401): the key is wrong, revoked, or the account has no API access.
Model unavailable (503): try another model or retry later.
Rate limited (429): up to 30 jobs per minute and 3 running at once.
Failed generations are refunded automatically.

Key dates

PyPI data

1 maintainer

PyPI data

Avatar for turbogen from gravatar.com turbogen

Tags

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

File	Size	Uploaded	Provenance
turbogen_mcp-0.1.2.tar.gz	11.4 kB	Nov 12, 2026	Without provenance	Details

Built distribution (wheel)

File	Interpreter	ABI	Platform
turbogen_mcp-0.1.2-py3-none-any.whl	Python 3	none	any	Details

Total release size: 22.0 kB

Download URL	turbogen_mcp-0.1.2.tar.gz
Size	11.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`5df8e40c0cc970d76bcfc71876839b215c5e673494c1298b0d589c25d8cb405f Copy SHA-256 checksum`
BLAKE2b-256 checksum How to use checksums	`42137f98658c08f6e0e4ad6f8386e6b1b90603f6d6d1b2a7076f418971712ff2 Copy BLAKE2b-256 checksum`
Upload date	Nov 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.9`

Download URL	turbogen_mcp-0.1.2-py3-none-any.whl
Size	10.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8b15617523b87c6df1b9c71ebb32cda2253c9d0e1e39ed939aeb8d1e38b8de9d Copy SHA-256 checksum`
BLAKE2b-256 checksum How to use checksums	`354990cc49a999673fc0dc3e42d9d22be88c4b9955ade8e1136be2a902f4500c Copy BLAKE2b-256 checksum`
Upload date	Nov 12, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.9`

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.