fattly — FATTLY CLI + MCP server

Generate AI images, video, voiceovers, music and UGC-style ads 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.

Code

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:

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

Tool	What it does	Spends credits
`fattly_credits`	Current credit balance	no (read-only)
`fattly_list_models`	Models and their price in credits	no (read-only)
`fattly_upload_image`	Upload a local photo → URL for edit / image-to-video models	no
`fattly_generate_image`	Text-to-image and image editing (multi-image edits, face swap)	yes
`fattly_generate_video`	Text-to-video and image-to-video; waits for the mp4	yes
`fattly_generate_audio`	Voiceover (text-to-speech) or music	yes

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

Terminal

npm install -g fattly   # Node.js 18+
fattly login            # paste your gpx_live_… key

bash

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.

Website: https://fattly.app
More than the MCP tools (AI dubbing with lip-sync, virtual try-on, UGC ad studio) is available in the web app.
Issues: https://github.com/industriesfatty-spec/fattly-mcp/issues