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
| Tool | What it does |
|---|---|
find_apps | Search the apps by what the user wants ("royal pet portrait", "fix an old photo") |
get_app | An app's inputs and looks, with example outputs, prompts and cost |
generate_from_app | Run an app's look on the user's photos |
generate_image | Text to image, or edit / combine photos |
generate_video | Text or image to video (returns an id; videos take minutes) |
generate_music | Write a song: describe it, bring lyrics, or go instrumental |
get_generation | Status and outputs of a run; can wait and save files |
list_models | Every model, its options and its credit cost |
account | Free tier or account, and the credits left |
open_in_tanvo | A link that opens the app, look or studio ready to go |
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.
| Variable | Meaning |
|---|---|
TANVO_API_KEY | Your API key (optional) |
TANVO_OUTPUT_DIR | Save every result into this folder (optional; each call can also pass save_to) |
TANVO_BASE_URL | Another deployment, e.g. a local build (default https://tanvo.ai) |
TANVO_ANON_ID | Fix the free-tier id instead of the one stored in ~/.config/tanvo-mcp/anon-id |
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