fattly — FATTLY CLI + MCP server
Turn a product photo into a UGC video ad, generate AI images, video and voiceovers — from your terminal or straight from AI assistants like Claude, Cursor and VS Code via MCP.
50+ AI models in one account (Veo 3.1, Kling 3, Seedance, Nano Banana, GPT Image, ElevenLabs…) · pay with fattly.app credits that never expire.
MCP (Claude, Cursor, VS Code)
The package is an MCP server — it lets AI assistants generate media through your FATTLY account.
Option A — Hosted (no install, sign in with OAuth)
Connect your client to the hosted server. No npm, no key to paste — you approve access in the browser.
https://fattly.app/api/mcp
In Claude: Settings → Connectors → Add custom connector → paste the URL. Full setup guide: https://fattly.app/claude-mcp
Option B — Local (npx, with an API key)
- On fattly.app open Dashboard → API keys and create a key.
- Add this to your client's MCP config:
{
"mcpServers": {
"fattly": {
"command": "npx",
"args": ["-y", "fattly", "mcp"],
"env": {
"FATTLY_API_KEY": "gpx_live_YOUR_KEY"
}
}
}
}
Installing with an AI agent (Cline, Claude Code, Cursor)? Point it at llms-install.md.
21 tools — the same set as the hosted server (the local server forwards every call to fattly.app with your key, so new tools appear without updating the package).
| Tool | What it does | Spends credits |
|---|
| Ad Studio | | |
fattly_generate_ad_video | UGC video ad: a real-looking AI creator presents your product on camera with a real voice (or hands-only POV / unboxing) | yes (~150) |
fattly_generate_ad | Ad image from a product photo: styled product scene or a creator holding it | yes (20) |
fattly_create_avatar | Your own consistent AI creator for ads | yes (20) |
fattly_list_ad_presets | Ad presets, scenes and creator avatars | no (read-only) |
| Images | | |
fattly_generate_image | Text-to-image and image editing (multi-image edits) | yes |
fattly_upscale | Upscale an image | yes |
fattly_remove_background | Clean cutout without background | yes |
fattly_inpaint | Repaint a masked area to match a prompt | yes |
fattly_face_swap | Swap a face (SFW, only faces you have the right to use) | yes |
| Video | | |
fattly_generate_video | Text-to-video and image-to-video (Veo, Kling, Seedance…) | yes |
fattly_video_status | Check a video that is still rendering | no (read-only) |
fattly_animate_photo | Bring a still photo to life | yes |
fattly_trend_video | Trend-style video from a photo and a preset | yes |
fattly_edit_video | Draw-to-Edit: change a masked region of a video with text | yes |
fattly_actor_swap | Replace the creator in an existing video | yes |
| Audio | | |
fattly_generate_audio | Voiceover (text-to-speech) or music | yes |
fattly_clone_voice | Clone a voice (with consent) or reuse a saved one | yes |
fattly_transcribe | Audio → text with timed segments | yes |
| Account | | |
fattly_credits | Current credit balance | no (read-only) |
fattly_list_models | Models and their price in credits | no (read-only) |
fattly_upload_image | Photo (URL, base64 or local file) → URL for edit / ad / image-to-video tools | no |
Every tool carries MCP annotations (readOnlyHint, destructiveHint, idempotentHint), so clients can ask before paid calls. Failed generations are refunded automatically. Content must be safe-for-work.
CLI
npm install -g fattly
fattly login
fattly credits
fattly models video
fattly generate "astronaut cat on Mars" --model nano-banana-2 --out cat.png
fattly video "ocean waves at sunset" --model kling-3-standard --out waves.mp4
fattly audio "Welcome to FATTLY" --voice Rachel --out voice.mp3
fattly audio "calm ambient" --music --seconds 30 --out music.mp3
Configuration
| Variable | Purpose |
|---|
FATTLY_API_KEY | API key (alternative to fattly login) |
FATTLY_API_URL | API address override (default https://fattly.app) |
The key saved by fattly login lives in ~/.fattly/config.json with owner-only permissions.
More
MIT © Fattly