Skip to content

fal MCP Server Make anything with 1,000+ models, right in your chat

Have your agent make commercials, product ads, UGC, 3D animation and whole storefronts without leaving your chat.

Every frame made with models on fal. Turn the sound on.

Setup

Connect fal in one click

One hosted server for every agent. Sign in with your fal account in the browser: no API key, and nothing to install for chat apps.

  1. Open the fal plugin page. Click Install plugin.
  2. Select Connect for the fal app if prompted. Complete browser sign-in and authorization.
  3. In a new chat, type @fal.
ChatGPT

@fal with FLUX 3 Max, make a ten-second Western shot: a pony-express rider at full gallop hands off the mail pouch at a relay post.

fal · FLUX 3 Max

The mail at full gallop. Turn the sound on in the corner.

Documentation

Read the MCP docs

Setup guides for every client, the full tool reference, and troubleshooting tips.

Open the Docs →
Dashboard

MCP & connectors

Choose which fal account your assistant bills: your personal account or a team.

Open Dashboard →
Community

Join the fal Discord

Share what you build, get help from the team, and see what others are running through MCP.

Join Discord →

Prefer to watch? The fal team walks through the ChatGPT and Claude setup, the Grok Bot plugin and building a 3D game with Claude Code on YouTube.

Workflows

Start with a standout workflow

A product, a character or an idea. See how far one prompt takes it.

Seedance 2.5Nano Banana Pro

Product shot to finished commercial

"Here's our new trail shoe, TERRA. Make a 15-second launch film: the lugged sole hitting mud in slow motion, a runner on a misty ridge at sunrise, splashing through a stream, a drone shot over the clouds, then a packshot on a mossy rock. Keep the shoe exactly like the photo."

Made by fal

Videos made by fal

Short films from fal's social channels, made with models on fal. Pick one and turn the sound on.

The Egg

A long dinner table, a room full of children and one very large egg.

Examples

What will you make?

Describe it in a sentence. Your agent picks the models, writes the shots and hands back finished media, with sound. Every example has a prompt you can run in ChatGPT or fal Agent.

45 examples

Launch film

Product shot to launch film

Seedance 2.5 · Nano Banana Pro

"Here's our new trail shoe, TERRA. Make a 15-second launch film: the lugged sole hitting mud in slow motion, a runner on a misty ridge at sunrise, splashing through a stream, a drone shot over the clouds, then a packshot on a mossy rock. Keep the shoe exactly like the photo."

Claymation

Storyboard to claymation ad

Seedance 2.5 · Nano Banana Pro

"Here's our storyboard and our mascot. Make a 15-second claymation ad for CRUMBLY'S oat bars that follows the six panels: the badger trudging uphill, a tummy rumble, pulling out the bar, the crunchy first bite, sprinting to the summit, then a packshot. Real stop-motion feel, fingerprints in the clay."

UGC

UGC skincare review

Seedance 2.5 · Nano Banana Pro

"Make a 12-second vertical UGC video for our SOLA vitamin C serum: a woman in her bathroom holds it up to her phone and says "Okay, three weeks with this vitamin C serum... and my skin is actually glowing? Like, no filter." Then she applies a drop and laughs. Handheld, natural light."

3D animation

A tiny snowplow saves the school bus

Seedance 2.5

"Make a 15-second 3D animated family-film scene with dialogue: a tiny, nervous yellow snowplow named Bertie clears a snowed-in mountain road so a stuck school bus can get down. He says "Okay. I can do this." and a girl on the bus shouts "Thank you, Bertie!""

3D animation

A paper lantern leads a lost girl home

FLUX 3 Max

"Make a 12-second 3D animated family-film scene: at a night market, a tiny glowing paper-lantern creature named Pip finds a lost little girl in a red raincoat, says "Follow me!" and lights the way back to her mother. She whispers "Thank you, Pip.""

UGC

UGC: new car day

FLUX 3 Max · Seedream 5.0 Pro · Nano Banana Pro

"Make a 15-second vertical selfie video of a woman picking up her new ORRA One electric car: "Okay... it's finally here. My new ORRA One. Look at this color!" She walks along it, gets in and shows the big screen: "And this screen is huge. I'm obsessed." Handheld, real, keep the car exactly like the photo."

E-commerce

Storefront hero video: SOLA skincare

Seedance 2.5 · Mirelo SFX 2.0 (sound)

"Make a calm 21:9 looping hero video for our skincare site: the SOLA serum on travertine, water rippling, palm shadows swaying, one drop falling. Keep the left half clear for the headline, with soft water sound."

Launch film

Launch film for an invented product

Seedance 2.5 · Nano Banana Pro

"Make a 15-second launch film for HALO, our new earbuds: macro of the case opening, the buds floating up, a woman on a noisy train putting one in as the noise falls away, a calm walk in the sun, and a clean packshot. Premium tech feel, no on-screen text."

Product ad

Sneaker in a powder explosion

Kling 3.0 · Mirelo SFX 2.0 (sound)

"Turn my sneaker photo into a 10-second ad: it bursts out of a cloud of pink and blue powder in slow motion on a white set, the shoe stays perfectly crisp. Add a big whoosh."

Lookbook

Lookbook look in motion

Seedream 5.0 Pro · H3 Max

"Make look 01 of the MAISON VERA lookbook move: she walks toward camera on the windswept cliff path, the oversized charcoal coat billowing, then turns to look out to sea. Slow handheld, film grain, wind and waves."

Photo shoot

Campaign shoot, behind the scenes

Seedream 5.0 Pro · Seedance 2.5

"Plan a SOLA summer campaign shoot in a sunlit warehouse studio: a model in a cream linen dress on a sand set. Give me behind-the-scenes photos, a BTS video with shutter clicks and flash pops, and three final campaign images."

Photo shoot

Lookbook shoot on the coast, BTS

Seedream 5.0 Pro · H3 Max

"Show me the behind the scenes of the MAISON VERA lookbook shoot on a windswept cliff: the photographer kneeling with a medium-format camera, an assistant fighting a silver reflector in the wind, the stylist letting go of the coat. Handheld, real, wind and shutter sounds."

Inside your agent

A whole creative studio, inside your agent

Launch films, storefronts, campaign shoots, lookbooks and storyboards, each from one conversation.

Product ads

Turn one product shot into a launch film

Drop in a photo and describe the spot. fal writes the shots and films every scene around your exact product: macro detail, lifestyle moments and a clean packshot, with sound.

  • Keeps the product's shape, color and logo in every shot
  • Native sound effects and score
  • 1080p, ready to cut or post

Here's our new trail shoe, TERRA. Make a 15-second launch film from it.

Attached photo

falmade a 15-second launch film

  • ✓ Read the product photo
  • ✓ Wrote 5 shots
  • ✓ 1080p with sound
E-commerce

Build a storefront with a hero video

Ask your coding agent for a store page and fal makes the hero loop and every product shot to match. Works in Cursor, Replit, Claude Code, Codex and VS Code.

  • 21:9 hero loops with room for your headline
  • Matching product shots and colorways
  • Saved straight into your project

Build a product page for SOLA skincare: a 21:9 hero loop of the serum on travertine with palm shadows, plus shots for the night cream and SPF.

Attached photo

falbuilt the storefront

  • ✓ Hero loop with sound
  • ✓ Product shots
  • ✓ Wrote the page
sola-skin.shop

SOLA

Sunlight, bottled.

Daily Vitamin C Serum · 30 ml

Daily Vitamin C SerumDaily Vitamin C Serum$48
Night Recovery CreamNight Recovery Cream$56
Mineral SPF 30Mineral SPF 30$34
Photo shoots

Run a campaign shoot, behind the scenes included

Cast a model, light the set and shoot the finals, then get behind-the-scenes photos and video for social. Same model, same product, every frame.

  • Real-camera look: grain, practical light, no plastic skin
  • One model across BTS and finals
  • BTS video with shutter clicks and flash pops

Plan and shoot a SOLA summer campaign: a model in a cream linen dress on a sand set with palm shadows. I want BTS photos and video plus the finals.

falshot the campaign

  • ✓ Seedream 5.0 Pro stills
  • ✓ Same model throughout
  • ✓ BTS video
Makeup touch-up on setFinal campaign image
Fashion

Shoot an editorial lookbook

One model, one palette and one story across every look, then put the collection in motion.

  • Six looks, one consistent model
  • Film-camera grain, real locations
  • Turn any look into a fashion film with H3 Max

Shoot a six-look lookbook for MAISON VERA AW26 'Salt & Iron': one model, charcoal, rust and cream, windswept coast and concrete. Then make look 01 move.

falshot the lookbook

  • ✓ Seedream 5.0 Pro
  • ✓ H3 Max motion
Look 02Look 03Look 04Look 05Look 06
Storyboards

From storyboard to finished spot

Sketch the beats yourself or let the agent draw them. fal then shoots every panel in the same world with the same character.

  • Agency-style boards with shot sizes and camera arrows
  • One character, held across every shot
  • Handmade claymation look, fingerprints included

Draw a six-panel storyboard for a 15-second claymation ad for CRUMBLY'S oat bars, then shoot it.

faldrew the board and shot it

  • ✓ Nano Banana Pro board
  • ✓ 6 shots, one badger
CRUMBLY'S storyboard
How to

Make it in ChatGPT, Claude or fal Agent

Pick an example. Each column shows exactly what to send in that app. Use fal Agent when you want a canvas with your assets, characters and every model one @ away.

Product ad

Start from one product photo. The agent plans the shots and keeps the product identical in each one.

Seedance 2.5Nano Banana Pro

Run it with FLUX 3 Max · Nano Banana Pro

ChatGPT

  1. Add the fal plugin once.
  2. Type @fal, attach your image if you have one, and send.

@fal with FLUX 3 Max, make this video: Make a 15-second ad from my product photo: a macro detail shot, two lifestyle shots and a clean packshot, with sound. Keep the product exactly like the photo.

Open in ChatGPT

Claude

  1. Add fal as a custom connector once.
  2. In a new chat: + → Connectors → fal, then send.

Use fal to do this: Make a 15-second ad from my product photo: a macro detail shot, two lifestyle shots and a clean packshot, with sound. Keep the product exactly like the photo.

Open in Claude

fal Agent

  1. Open fal Agent. The model is picked for you.
  2. Type @ to pull in your assets and characters, then send.

Make a 15-second ad from my product photo: a macro detail shot, two lifestyle shots and a clean packshot, with sound. Keep the product exactly like the photo.

Open in fal Agent
Tools

Tools, zero configuration

The MCP server exposes tools that your assistant picks automatically. You never call them directly — you just describe what you want.

Discover
search_models

Search the catalog by keyword or category.

recommend_model

Describe the task; get candidate models and published guidance.

browse_models

Browse trending and recently added models by category.

get_model_schema

Read a model's exact inputs and outputs before running it.

search_guidance, read_guidance, search_docs

Read fal's prompting and model-routing guidance and docs.

Price and account
get_pricing

Unit prices for up to 50 models in one call.

estimate_cost

Estimate one request from its real inputs. Advisory, not a quote.

list_model_sets

Use your Sandbox model sets for side-by-side comparisons.

check_account_status, list_accounts, select_account

See which fal account is billed and switch to a team you belong to.

Generate
run_model

Run a model and wait a bounded time for the result.

submit_job, submit_jobs

Queue long video and 3D jobs, or up to 8 requests at once.

check_job, wait_for_jobs

Follow queued jobs without resubmitting them.

get_job_result, cancel_job

Fetch finished output, or cancel a job you no longer need.

Your inputs
upload_file

Upload from a public URL, base64, or a signed upload up to 90 MB.

upload_attachment, verify_upload

Import a chat attachment where the app allows it, and confirm the upload.

inspect_images

Look at up to 4 existing images before editing them.

Workflows
prepare_media_workflow

Check up to 8 chained steps against live schemas before spending credits.

prepare_media_transform

Plan an upscale, cutout, HDR delivery or video outpaint.

resolve_model_inputs

Turn saved assets, characters and past jobs into valid model inputs.

prepare_deliverables

Check up to 32 outputs against the delivery you asked for.

Library and history
save_job_outputs, save_asset

Save results to your fal library, keeping where they came from.

search_assets, list_collections

Find saved media and organize it into collections.

create_entity, list_entities

Keep reusable characters, props, environments, styles and scenes.

search_request_history, get_job_recipe

Find past generations from the last 90 days and their exact settings.

show_media, open_library

Preview results and browse your library in apps that display MCP Apps, such as ChatGPT.

How it works

Stateless, isolated, and free to use

Your assistant sends a request to mcp.fal.ai signed in with your fal account, the server calls the fal Platform API on your behalf, and the results come straight back to your conversation.

Hosted and stateless

The server is fully stateless and hosted on Vercel. No sessions, no state — each request is completely isolated.

No API key to paste

Your client signs in to your fal account in the browser. There is no key to create, paste into a config file, or rotate.

Free to use

The MCP server is free. You only pay for the model runs you trigger, at standard fal pricing.

FLUX 3 Max and H3 Max first

FLUX 3 Max for cinematic shots and H3 Max for people and faces, next to Seedance, Kling, Nano Banana and the rest of the catalog.

Chain whole workflows

Image to video to upscale to sound in one request, with up to eight jobs running in parallel.

Your library comes with you

Outputs save to your fal media library and request history, so you can pick them up in another app.

Industries

Built for every industry

Teams in advertising, retail, fashion, games, film and education run these workflows on fal. Now they run from a chat.

Advertising

Hero ads, variants and spokespeople

Product VFX shots, campaign variants for every market, and AI spokespeople with designed voices.

E-commerce

Storefronts that move

21:9 hero loops, 360° spins, new colorways and UGC-style reviews from one product photo.

Fashion

Lookbooks and campaign shoots

One consistent model across six looks, behind-the-scenes content, try-on and runway motion.

Gaming

Concept art to trailer

Cinematic shots from concept art, consistent sprite sheets and 3D meshes for prototypes.

Film & animation

Storyboards to finished scenes

Multi-shot scenes with the same characters, 3D animated stories with dialogue, dubbing and VFX.

Education

Explainers and lessons

Narrated explainers and animated lessons, from script to subtitles in one request.

FAQ

Common questions about the fal MCP Server

What is the fal MCP Server?

The fal MCP Server is a hosted endpoint at https://mcp.fal.ai/mcp-relay that lets any AI assistant search, run, and chain 1,000+ generative AI models on fal directly from a conversation. It is built on the Model Context Protocol (MCP), an open standard that lets AI assistants use external tools. Your assistant doesn't just generate code that calls fal — it actually calls fal.

Which AI assistants are supported?

Any MCP-compatible client with OAuth sign-in works. ChatGPT, Claude, Claude Code, Codex, Cursor, Grok Bot, Muse, Instinct and Replit have setup steps on this page; Cursor and Grok Bot install fal as a plugin from the Cursor Marketplace. Other clients connect to the same server URL.

Can ChatGPT and Claude make videos?

Yes, once fal is connected. Your assistant calls video models on fal, such as FLUX 3 Max, H3 Max, Seedance and Kling, and returns the finished file in the chat. Every example on this page was made with models on fal.

Which video model should I use?

Start with FLUX 3 Max for cinematic shots, product films and animation, and H3 Max when people and faces matter, such as UGC, lookbooks and spokespeople. Your assistant can also search the catalog and compare prices before it runs anything.

How do I add fal to all my coding agents at once?

Run curl -fsSL https://fal.ai/mcp/install.sh | bash on macOS or Linux. It adds the fal server to Claude Code, Codex CLI, Cursor, VS Code, Devin Desktop (Windsurf), Gemini CLI, Grok Build and opencode, skips any that are already set up, and writes no API key. Then complete browser sign-in once in each agent.

Do I need an API key?

No. Your client signs in to your fal account in the browser, so there is no key to create or paste. Only clients that can't sign in with MCP OAuth need a key: send it as Authorization: Key <key_id>:<key_secret> to the same URL.

I set it up with an API key before. What changed?

The old setup used an API key in an Authorization header and now fails with 401. Remove that fal entry from your client and add https://mcp.fal.ai/mcp-relay again without a header, then sign in in the browser.

How much does it cost?

The MCP server itself is free. You only pay for the model runs your assistant triggers, at standard fal pricing — the same rates as calling the API directly. Your assistant can even check the price of a model with the get_pricing tool before running it.

Which fal account gets billed?

Your Active MCP account: your personal account by default. To use a team's credits, select the team in MCP & connectors (fal.ai/dashboard/ai-tools). New requests switch without reconnecting.

What tools does the server expose?

Tools for finding models (search_models, recommend_model), checking prices (get_pricing, estimate_cost), running and queueing generations (run_model, submit_job, check_job), uploading inputs (upload_file), and saving results to your fal library. Your assistant picks them automatically — you just describe what you want.

Can my assistant chain multiple models together?

Yes — that's one of the biggest advantages. A single request like "generate a futuristic Tokyo street, upscale it to 4K, and describe what's in it" chains generation, upscaling, and analysis in one conversation. The assistant handles uploads, queueing, and passing results between models.

Can I use my own images?

Yes. Give your assistant a public URL, or attach the file in an app that shares attachments with tools. The hosted server can't read files on your computer.

The fal tools don't show up. What should I check?

Finish the browser sign-in, then start a new chat or session. In Claude, enable fal from the + menu under Connectors; in ChatGPT, type @fal. Check that the server URL is https://mcp.fal.ai/mcp-relay and that no Authorization header is set.

Ready to transform your enterprise with AI?

Take the first step towards AI-driven innovation. Our team of ML engineers is ready to help you prototype, develop, and scale your AI solutions.

Enterprise Contact Form