Fattly

io.github.industriesfatty-specPublished by GitHub account industriesfatty-specv0.1.2Updated Oct 25, 2026

AI images, video, voiceovers and UGC ads from 50+ models. Official MCP server for fattly.app.

VerifiedStreamable HTTPWeb executableBusiness & CommerceMedia & Design

Overview

AI-generated overview

Fattly lets an assistant generate AI images, video, voiceovers and UGC video ads through a Fattly account, using 50+ models paid for with credits.

What you can do
Generate ad videos, ad images and consistent AI creator avatars, and browse ad presets and scenes read-only. Create and edit images: text-to-image, multi-image edits, upscaling, background removal, inpainting and face swap. Produce video from text or images, animate photos, make trend videos, edit masked regions and swap actors, and check render status. Generate voiceovers or music, clone voices with consent, and transcribe audio to timed text. Check credit balance, list models with credit prices, and upload images for use in other tools.
When to use it
Useful when you want an assistant to produce marketing or social media media — product ad images and UGC-style video ads, images, video clips, voiceovers or music — without leaving the chat, and you already have or are willing to buy Fattly credits.
Requirements
Either the hosted remote endpoint with OAuth sign-in in the browser, or the local npm package run with npx (Node.js 18+) and a FATTLY_API_KEY from the Fattly dashboard. A Fattly account with credits is needed for paid generations; network access to fattly.app.
Before you install
Most generation tools spend Fattly credits, some around 150 per ad video and 20 per ad image; failed generations are refunded automatically. The API key is a secret and the local login stores it in a config file. Face swap, voice cloning and actor swap involve likeness and voice rights, and all content must be safe-for-work. The local server forwards every call to fattly.app.

Installation

In SourceWeft

  1. Open Fattly in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.industriesfatty-spec%2Ffattly/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "fattly": {
      "type": "http",
      "url": "https://fattly.app/api/mcp"
    }
  }
}

README

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.

[npm] [CI] [License: MIT] [fattly MCP server]

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)

  1. On fattly.app open Dashboard → API keys and create a key.
  2. Add this to your client's MCP config:
json
{  "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).

ToolWhat it doesSpends credits
Ad Studio
fattly_generate_ad_videoUGC 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_adAd image from a product photo: styled product scene or a creator holding ityes (20)
fattly_create_avatarYour own consistent AI creator for adsyes (20)
fattly_list_ad_presetsAd presets, scenes and creator avatarsno (read-only)
Images
fattly_generate_imageText-to-image and image editing (multi-image edits)yes
fattly_upscaleUpscale an imageyes
fattly_remove_backgroundClean cutout without backgroundyes
fattly_inpaintRepaint a masked area to match a promptyes
fattly_face_swapSwap a face (SFW, only faces you have the right to use)yes
Video
fattly_generate_videoText-to-video and image-to-video (Veo, Kling, Seedance…)yes
fattly_video_statusCheck a video that is still renderingno (read-only)
fattly_animate_photoBring a still photo to lifeyes
fattly_trend_videoTrend-style video from a photo and a presetyes
fattly_edit_videoDraw-to-Edit: change a masked region of a video with textyes
fattly_actor_swapReplace the creator in an existing videoyes
Audio
fattly_generate_audioVoiceover (text-to-speech) or musicyes
fattly_clone_voiceClone a voice (with consent) or reuse a saved oneyes
fattly_transcribeAudio → text with timed segmentsyes
Account
fattly_creditsCurrent credit balanceno (read-only)
fattly_list_modelsModels and their price in creditsno (read-only)
fattly_upload_imagePhoto (URL, base64 or local file) → URL for edit / ad / image-to-video toolsno

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

bash
npm install -g fattly   # Node.js 18+fattly login            # paste your gpx_live_… key
bash
fattly creditsfattly models video
fattly generate "astronaut cat on Mars" --model nano-banana-2 --out cat.pngfattly video "ocean waves at sunset" --model kling-3-standard --out waves.mp4fattly audio "Welcome to FATTLY" --voice Rachel --out voice.mp3fattly audio "calm ambient" --music --seconds 30 --out music.mp3

Configuration

VariablePurpose
FATTLY_API_KEYAPI key (alternative to fattly login)
FATTLY_API_URLAPI address override (default https://fattly.app)

The key saved by fattly login lives in ~/.fattly/config.json with owner-only permissions.

More

MIT © Fattly

Source: README.md at commit 45d16b9

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts