io.github.industriesfatty-spec/fattly
AI images, video, voiceovers and UGC ads from 50+ models. Official MCP server for fattly.app.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http fattly 'https://fattly.app/api/mcp'{
"mcpServers": {
"fattly": {
"type": "http",
"url": "https://fattly.app/api/mcp"
}
}
}fattlyclaude mcp add fattly -e 'FATTLY_API_KEY=<your fattly_api_key>' -- npx -y fattly@0.1.2 mcp{
"mcpServers": {
"fattly": {
"command": "npx",
"args": [
"-y",
"fattly@0.1.2",
"mcp"
],
"env": {
"FATTLY_API_KEY": "<your fattly_api_key>"
}
}
}
}Environment variables
FATTLY_API_KEYrequired secret Your Fattly API key (gpx_live_...), from Dashboard > API keys on fattly.app
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
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/mcpIn 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.
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 |
| 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 # Node.js 18+
fattly login # paste your gpx_live_… keyfattly 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.mp3Configuration
| 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
- Website: https://fattly.app
- Even more in the web app: AI dubbing with lip-sync in 5 languages, virtual try-on, Cinema Studio.
- Issues: https://github.com/industriesfatty-spec/fattly-mcp/issues
MIT © Fattly
Frequently asked questions
What is io.github.industriesfatty-spec/fattly?
AI images, video, voiceovers and UGC ads from 50+ models. Official MCP server for fattly.app.
How do I install io.github.industriesfatty-spec/fattly?
It runs as a remote server. In Claude Code: claude mcp add --transport http fattly 'https://fattly.app/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.industriesfatty-spec/fattly need an API key?
Yes. It expects FATTLY_API_KEY, which you set in its configuration.
Is io.github.industriesfatty-spec/fattly open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.industriesfatty-spec/fattly?
It is published by industriesfatty-spec. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.