Skip to main content
Glama
Sign In
deenesjakoruzh
Fattly

Fattly

by industriesfatty-spec
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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:

{
  "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.

Related MCP server: mcp-media-engine

CLI

npm install -g fattly   # Node.js 18+
fattly login            # paste your gpx_live_… key
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

Available Tools

6 tools
fattly_creditsCheck credit balanceA
Read-onlyIdempotent
Inspect

Shows the current credit balance on the FATTLY account. Read-only and free — call it before an expensive generation to make sure the user has enough credits.

Inputs: no named parameters.

fattly_generate_audioGenerate a voiceover or musicAInspect

Generates AI audio: a voiceover (mode=speech) from text, or music (mode=music) from a description. Returns a link to the mp3 file. Spends credits (price in fattly_list_models → audio); refunded automatically if the generation fails.

Inputs: mode (required), text (required), voice, seconds.

fattly_generate_imageGenerate an imageAInspect

Generates an AI image from a prompt (or edits uploaded images). Returns links to the finished images. Spends credits: model price × numImages (see fattly_list_models); fails with an error if the balance is too low, and credits are refunded automatically when a generation fails. Prompts must be safe-for-work.

Inputs: prompt (required), model, numImages, aspectRatio, +2 more.

fattly_generate_videoGenerate a videoAInspect

Generates an AI video from a prompt (or from a start image). Takes a few minutes — the tool waits (up to 10 min) and returns a link to the mp4 file. Video is the most expensive operation: it spends the model's credit price (see fattly_list_models), so confirm the model and cost with the user first. Credits are refunded automatically if the generation fails.

Inputs: prompt (required), model, duration, aspectRatio, +1 more.

fattly_list_modelsList models and pricesA
Read-onlyIdempotent
Inspect

Returns available models and their cost in credits (images, video, audio). Read-only and free. Use before generating to pick the right model id and to tell the user what a generation will cost.

Inputs: category.

fattly_upload_imageUpload a local imageAInspect

Uploads a local image file (JPG, PNG or WEBP) to FATTLY and returns a public fal URL. Use this to turn a photo on disk into an inputImageUrl for editing / face-swap / image-to-video models: pass the returned URL as inputImageUrl to fattly_generate_image or fattly_generate_video. No credits are charged for the upload.

Inputs: filePath (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.4/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct resource/action: credits, models, upload, image generation, video generation, audio generation. No two tools overlap in purpose; the generation tools are clearly separated by output modality.

    Naming Consistency4/5

    All tools share the 'fattly_' prefix and use a consistent verb_noun pattern (list_models, upload_image, generate_image). The only minor deviation is 'fattly_credits' which is a noun rather than a verb_noun like 'get_credits' or 'check_credits'.

    Tool Count5/5

    Six tools is well-scoped for a media generation server: one for account state, one for catalog/pricing, one for input preparation, and three for the core generation modalities. Each tool earns its place.

    Completeness4/5

    The core lifecycle is covered: check credits, list models, upload input, generate image/video/audio. Minor gaps exist (no tool to fetch a generation result by ID, no explicit cancel/delete), but the server's stated purpose of generating media is fully covered.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers