industriesfatty-spec/fattly-mcp

**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.
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)
1. On fattly.app open **Dashboard → API keys** and create a key.
2. Add this to your client's MCP config:
Installing with an AI agent (Cline, Claude Code, Cursor)? Point it at llms-install.md.
Tools
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 |