Developers
MCP server
Ask your assistant for a picture, a clip or a song and get the file back. Tanvo's apps and models inside Claude, Cursor, Codex and any MCP client.
Install
The server runs with npx, so there is nothing to install first (Node 20+). Without TANVO_API_KEY it starts on the free tier.
claude mcp add tanvo -- npx -y tanvo-mcp
# with an API key
claude mcp add tanvo -e TANVO_API_KEY=sk_... -- npx -y tanvo-mcpTools
| Tool | What it does |
|---|---|
find_apps | Search the 80 apps by what the user wants ("royal pet portrait", "fix an old photo", "birthday song") |
get_app | An app's inputs and preset looks, with example outputs, prompts and cost |
generate_from_app | Run an app's look on the user's photos; local files are uploaded for you |
generate_image | Text to image, or edit and combine photos, on any image model |
generate_video | Text or image to video, with start and end frames and native sound where supported |
generate_music | A song on Suno V6: describe it, bring lyrics, or go instrumental |
get_generation | Status and outputs of a run; can wait and save the 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 in the browser |
What to ask
- “Make my dog look like a Renaissance oil painting. ~/Pictures/rex.jpg”
- “Turn this selfie into a boxed action figure on a desk.”
- “Restore this old family photo and save it to ~/Desktop.”
- “Animate this product photo into a slow 360° spin, 9:16, for a Reel.”
- “Write a birthday song for my sister Ana: surfing, terrible puns, a big chorus.”
- “Make a 16:9 hero image for this blog post with Nano Banana 2 at 2K.”
Free tier and keys
Without a key the server uses the anonymous free tier: the house image engine (studio-image-v1), watermarked, a few images per machine a day. Apps on premium models, video and songs need a key; when a call needs one, the server answers 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. It runs on your account: the same models, prices and plan as the website, and every run lands in your history. Failed runs are refunded automatically.
Settings
| 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 (default https://tanvo.ai) |
TANVO_ANON_ID | Fix the free-tier id instead of the one stored in ~/.config/tanvo-mcp/anon-id |
Prompts and photos you pass are sent to Tanvo to run the job, under the privacy policy, and are moderated before anything runs. The server stores nothing except the free-tier id.
Where it is listed
- Source: github.com/tanvoai/tanvo-mcp (MIT)
- npm: tanvo-mcp
- Official MCP Registry:
ai.tanvo/tanvo-mcp - Building something larger? Use the API or the Python and JavaScript SDKs from the developer overview.