avots-mcp
Official MCP (Model Context Protocol) server for avots.ai - a multi-provider AI platform.
One connection gives you:
- 🖼 Image generation & editing - Nano Banana (Gemini 3 Pro / 3.1 Flash), GPT-5 Image, FLUX, Recraft (incl. native vector SVG), Ideogram
- 🎬 Video generation & editing - Veo 3.1, Seedance 2.0, Kling v3.0 Pro, Sora 2 Pro, Grok Imagine, Gemini Omni Flash (async, 1-8 min); plus scene edit, face swap and lip-sync re-voicing of existing clips
- 🧑🎤 Talking heads & avatars - saved reusable face identities, talking-avatar videos, vertical AI-vlogs for Shorts / TikTok
- 🎵 Music & audio - ElevenLabs Music, ACE-Step, Stable Audio, TTS narration (incl. cloned voices)
- 🎨 Studio templates - photo-montage reels, vintage travel posters, viral trend recreation with your face
- 💬 300+ chat models - Claude (Sonnet / Opus), GPT-5, Gemini 3, DeepSeek, Sonar, and more - billed through one balance
The server lives at https://mcp.avots.ai/ and speaks the MCP 2025-06-18 spec over Streamable HTTP. Tools are billed per call against your avots balance (same balance you'd see on the web app or the Telegram bot).
Quick start
- Sign up at avots.ai and mint an MCP key at Settings → Integrations (it looks like
av_mcp_<48hex>). - Pick your client from the table below and follow the linked guide.
- Try it - ask your client "generate an image of a fox in a snowy forest" and watch tokens get spent.
Ready-to-paste mcp.json snippets live under examples/.
What's in the server
Nineteen tools, all documented in docs/tools.md:
About the two-step video flow. Video is the most expensive tool. To avoid surprise spend,
generate_videoreturns a preview card the first time it's called (no submit, no reserve). The client (e.g. Claude) shows the cost + alternative models with prices and asks the user. The user confirms, the client re-calls with the chosenmodel+confirmed: true, and only then does the job get submitted. On submit error the server returns the same alternatives card - it never silently swaps to a pricier model.
What you can build
A few things this is actually useful for. Each one chains two or more tools through one connection and one balance.
- Social ad creative in one prompt — hero image, animated variant, music bed.
- Product-photo angle pack — one product shot in, four angles + a rotation clip out.
- Storyboard to animatic — four script-driven frames animated into a 12-second rough cut.
- Vertical Reels / Shorts factory — 9:16 clip + matching 15-second music bed, repeatable per video.
- Podcast cover art + show notes — four cover variations and a written episode description for each.
- Second-opinion delegation — forward a tricky problem to a model from a different lineage and compare.
- Localized brand assets — translated copy and locale-tuned visuals across markets.
Each of these flows is written out as a runnable script — exact prompt, tool sequence, model picks, cost — in docs/recipes.md.
Cost ranges from ~200⚡ for a single image to ~5000⚡ for a 10-second 1080p Kling Pro clip — run list_models (free) at any time for live per-call prices.
Billing
All tool calls bill against your avots balance, just like the web app and Telegram bot. No separate metering. Daily USD cap (set in Settings) and per-key rate limits apply.
See pricing.avots.ai for token packs and subscriptions.
Troubleshooting
Common cross-client issues (401s, daily caps, two-step video flow, image rendering, npx PATH gotchas) are collected in docs/troubleshooting.md. For client-specific setup, see the per-client guide linked in the table above.
Issues & feedback
Open an issue here, or write to [email protected]. For platform questions (billing, models, web app) the Telegram bot @AvotsAIbot is the fastest channel.
License
MIT - feel free to fork the docs, the examples, and anything else here.