Tanvo MCP

The MCP server for Tanvo, an AI image, video and music studio. Ask your assistant for "a renaissance portrait of my cat from this photo", "turn this selfie into a boxed action figure", "a 10-second clip of this product spinning" or "a birthday song for Sam", and it runs it on Tanvo and hands you the file.

Works in Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Codex, Gemini CLI and any other MCP client. No API key needed to try it: the house image engine runs on the free tier.

What it can do

• 80 ready-made apps with 350+ preset looks. Pet portraits, figurines, old photo restoration, AI baby, product photos, outfit try-on, trend videos (hotel lobby duet, crying filter, dance), birthday and love songs. Each look is a tuned prompt with a real example output, so you know what you will get.
• Images on Nano Banana 2 / Pro, Seedream 5, GPT Image 2.5, Qwen Image, Grok Imagine and the free house engine: text to image, edits and multi-photo compositions.
• Video on Veo 3.1, Kling 3.0, Seedance 2.5, Wan, Minimax and more: text to video, image to video, start and end frames, native sound.
• Songs on Suno V6: two takes per run, each an MP3 with cover art, a title and the lyrics.
• Local photos are uploaded for you, and results can be saved straight into a folder.

Tools

Install

The server runs with npx, so there is nothing to install first (Node 20+).

Claude Code

claude mcp add tanvo -- npx -y tanvo-mcp

Add -e TANVO_API_KEY=sk_... to run on your account.

Claude Desktop, Cursor, Windsurf, Cline, VS Code (the mcpServers block of the client's MCP config)

{
  "mcpServers": {
    "tanvo": {
      "command": "npx",
      "args": ["-y", "tanvo-mcp"],
      "env": { "TANVO_API_KEY": "sk_..." }
    }
  }
}

Gemini CLI

gemini extensions install https://github.com/tanvoai/tanvo-mcp

Codex (~/.codex/config.toml)

[mcp_servers.tanvo]
command = "npx"
args = ["-y", "tanvo-mcp"]
env = { TANVO_API_KEY = "sk_..." }

AI agents that install servers themselves (Cline and others) can follow llms-install.md.

Free tier and API keys

Without a key the server uses Tanvo's anonymous free tier: the house image engine (studio-image-v1), watermarked, a few images per machine per day. Everything else (apps on premium models, video, songs) needs a key. When a call needs one, the server replies with a link that opens the same app or prompt in the browser, where new accounts start with free credits.

Create a key under Settings → API keys. A key runs on your own account: the same models, prices and plan as the website, and every run lands in your history. Each run's price is shown by get_app / list_models, and failed runs are refunded automatically.

Examples

Make my dog look like a Renaissance oil painting. ~/Pictures/rex.jpg

find_apps → get_app ai-pet-portrait-generator → generate_from_app with look renaissance and the photo.

Write a birthday song for my sister Ana, she loves surfing and terrible puns. Save it to ~/Music.

generate_music in Describe mode with save_to: "~/Music".

Animate this product photo into a slow 360° spin, 9:16.

find_apps "product spin" → generate_from_app product-spin, then get_generation until it is done.

Privacy

Prompts and photos you pass are sent to tanvo.ai to run the job, under the privacy policy. Content is moderated before anything runs. The server stores nothing except the anonymous free-tier id.

Develop

npm install
npm run build
TANVO_BASE_URL=http://localhost:3210 node dist/index.js

Docs: tanvo.ai/developers/mcp · API reference: tanvo.ai/developers/api · OpenAPI: tanvo.ai/openapi.yaml

Also from Tanvo

• tanvo-python: pip install tanvo
• tanvo-js: npm install @tanvoai/sdk

License

MIT