Tanvo MCP
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TANVO_ANON_ID | No | Fix the free-tier id instead of the one stored in ~/.config/tanvo-mcp/anon-id. | |
| TANVO_API_KEY | No | Your Tanvo API key (optional). Without a key the server uses Tanvo's anonymous free tier. A key runs on your own account with the same models, prices and plan as the website. | |
| TANVO_BASE_URL | No | Another Tanvo deployment, e.g. a local build (default https://tanvo.ai). | https://tanvo.ai |
| TANVO_OUTPUT_DIR | No | Save every result into this folder (optional; each call can also pass save_to). |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| find_appsA | Search Tanvo's ready-made AI apps (photo effects, trends, portraits, product shots, video effects, songs) by what the user wants, e.g. 'royal pet portrait', 'action figure of me', 'old photo restoration', 'dancing video', 'birthday song'. Each app has tuned preset looks with real example outputs. Use get_app for the looks, then generate_from_app to run one. |
| get_appA | One Tanvo app: the photos it needs, its preset looks (each with an example output and the prompt behind it), the model it runs on and the link that opens it in the browser. |
| list_modelsA | Every image, video and music model with the options each accepts (aspect, resolution, duration, format, audio), how many reference images it takes, whether the free tier covers it, and its credit cost at default settings. |
| accountA | Who the server runs as (an API key account or the anonymous free tier) and how many credits are left. |
| generate_from_appA | Run one of Tanvo's apps with one of its looks on the user's photos, e.g. the 'renaissance' look of a pet portrait app. Photos go in the order of the app's inputs (see get_app). Uses the look's tuned prompt and model; |
| generate_imageA | Text to image, or an edit / combination when |
| generate_videoA | Text to video, or animate a still when |
| generate_musicA | Makes two takes of a song on Suno V6, each an MP3 with cover art, a title and the lyrics as sung. Modes: Describe (prompt is one sentence about the song; lyrics are written for you), Lyrics (prompt is your lyrics, with [Verse] [Chorus] [Bridge] tags), Instrumental (prompt describes the sound). 60 credits a run; needs TANVO_API_KEY. |
| get_generationB | Status and outputs of a run started earlier (poll this for videos). |
| open_in_tanvoA | A link that opens Tanvo ready to go: an app on a chosen look, or the image / video / music studio with a model and prompt filled in. Use it when the user wants to upload photos and tweak settings themselves, or has no API key. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
The generation tools are cleanly separated by media type (image, video, music) and by source (generate_from_app vs generate_image), and discovery tools (find_apps, get_app, list_models) have distinct roles. The only mild tension is generate_image vs generate_from_app (both yield images) and open_in_tanvo vs the generate_* family (both can set up a creation), but descriptions make the boundaries clear.
Eight of ten tools follow a consistent snake_case verb_noun pattern (generate_image, generate_video, generate_music, find_apps, get_app, get_generation, list_models, generate_from_app). Deviations are minor: 'account' is a bare noun, and 'open_in_tanvo' is verb_preposition_noun, both still readable and unambiguous.
Ten tools is well-scoped for a media-generation service: discovery (2), details (1), generation (4), status (1), account (1), and a browser escape hatch (1). Each tool earns its place with no redundancy.
The surface covers the full create-and-poll lifecycle across image, video, music, and preset apps, plus model catalog and account/credit visibility. Minor gaps remain: no cancel/delete for in-flight generations and no credit top-up or history listing, though agents can work around these.