MCP
Fantygen MCP server
Use Fantygen from AI coding assistants and agents through the Model Context Protocol. Your assistant can price, generate, upload and download with your own account, plan and credits.
The quickest way: let your assistant set it up
Copy this text and paste it into Claude Code, Copilot, Codex, OpenCode, Cursor or Gemini CLI. It adds the server, then tells you how to sign in.
Set up the Fantygen MCP server for me.
Server name: fantygen
URL: https://app.fantygen.com/mcp (Streamable HTTP, OAuth sign-in in the browser)
1. Work out which assistant you are and add the server the way it expects. Keep everything already in these files.
- Claude Code: run claude mcp add --transport http --scope user fantygen https://app.fantygen.com/mcp
- VS Code / GitHub Copilot: in .vscode/mcp.json add "fantygen": { "type": "http", "url": "https://app.fantygen.com/mcp" } under "servers"
- Codex: in ~/.codex/config.toml add [mcp_servers.fantygen] with url = "https://app.fantygen.com/mcp", then run codex mcp login fantygen
- OpenCode: in opencode.json add "fantygen": { "type": "remote", "url": "https://app.fantygen.com/mcp", "enabled": true } under "mcp", then run opencode mcp auth fantygen
- Cursor: in ~/.cursor/mcp.json add "fantygen": { "url": "https://app.fantygen.com/mcp" } under "mcpServers"
- Gemini CLI: in ~/.gemini/settings.json add "fantygen": { "httpUrl": "https://app.fantygen.com/mcp" } under "mcpServers"
2. Tell me exactly how to finish: a browser window opens, I sign in to Fantygen and press Allow. In Claude Code that is /mcp, then fantygen. If the tools only appear after a restart, tell me.
3. When I say I am signed in, call the fantygen whoami tool and tell me my plan and credits.
From then on: always call quote and tell me the price before generate, and never spend credits I have not agreed to.How it works
01
Add the server
Add the URL to your assistant with one of the snippets below.
02
Sign in
A browser window opens. Sign in to Fantygen and choose what the assistant may do.
03
Ask
Ask in plain words: a hero image, a 9:16 product video, a voiceover. The assistant prices it first, then generates and downloads the file.
Or set it up yourself
Claude Code
Terminalclaude mcp add --transport http fantygen https://app.fantygen.com/mcpThen run /mcp in Claude Code and choose fantygen to sign in.
VS Code · GitHub Copilot
.vscode/mcp.json{
"servers": {
"fantygen": {
"type": "http",
"url": "https://app.fantygen.com/mcp"
}
}
}Press Start above the server in mcp.json and sign in when asked. Use it in Copilot Chat's Agent mode.
Codex
~/.codex/config.toml[mcp_servers.fantygen]
url = "https://app.fantygen.com/mcp"Then sign in with: codex mcp login fantygen
OpenCode
opencode.json{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"fantygen": {
"type": "remote",
"url": "https://app.fantygen.com/mcp",
"enabled": true
}
}
}Then sign in with: opencode mcp auth fantygen
Cursor
~/.cursor/mcp.json{
"mcpServers": {
"fantygen": {
"url": "https://app.fantygen.com/mcp"
}
}
}Open Cursor Settings → MCP and press Connect next to fantygen.
Gemini CLI
~/.gemini/settings.json{
"mcpServers": {
"fantygen": {
"httpUrl": "https://app.fantygen.com/mcp"
}
}
}Then run /mcp auth fantygen in Gemini CLI.
Claude Desktop · claude.ai
Settings → Connectors → Add custom connectorhttps://app.fantygen.com/mcpPaste the URL, then press Connect and sign in.
API key
Any client that sends headersclaude mcp add --transport http fantygen https://app.fantygen.com/mcp \
--header "Authorization: Bearer fgk_your_key"Create the key in Developer tools. It works without a browser sign-in.
Try asking
- Make a 1200×630 hero image for this landing page in our brand colours and save it to public/hero.webp.
- Turn public/product.png into a 6-second 9:16 video for Instagram Reels. Tell me the price first.
- Write a 20-second voiceover for the app intro and make it with a warm English voice.
- Show me my last 5 generations and download the videos into ./media.
- Read https://example.com and plan a 30-second YouTube ad from it. Don't approve until I say so.
What the assistant can do
- Account and models
- whoami, list_models, list_voices, quote
- Generate
- generate, wait_for_job, get_job, list_jobs, delete_job, share_link
- Files
- upload_file, create_upload_url, import_image_from_url, list_files, delete_file, get_download_url
- Library
- list_characters, save_character, delete_character, get_brand_kit, set_brand_kit
- Templates and plans
- list_templates, plan_from_template, get_plan, edit_plan_steps, approve_plan, cancel_plan, retry_plan, regenerate_step
- Assistant, websites and editor
- ask_assistant, get_conversation, read_website, update_website_kit, list_projects, export_project, list_exports
Credits and safety
- ✓Every paid action needs the price the assistant was quoted. If the price changed, nothing runs.
- ✓Your plan's limits apply exactly as in the app: models, resolution, parallel jobs, export minutes.
- ✓Choose Read only when you connect, and the assistant can look and download but never spend.
- ✓See each connected app, its last use and its spending in Developer tools, and revoke it with one click.
- ✓Download links last one hour; upload links work once, for 15 minutes.
Troubleshooting
- The browser window did not open
- Copy the sign-in link your assistant prints and open it yourself, or connect with an API key.
- "needs an active plan"
- MCP works on every paid plan. Choose one under Plan & billing, then try again.
- "does not have the generate permission"
- You connected with Read only. Revoke the connection in Developer tools and connect again with Generate.
- The connection stopped working
- It may have been revoked or the sign-in expired. Remove the server in your assistant, add it again and sign in.
Questions
Do I need a plan?
Yes. MCP access is included in every paid plan and uses your plan's credits.
My assistant cannot sign in through a browser.
Create an API key in Developer tools and send it as Authorization: Bearer <key>.
How does the assistant send my files?
Small files go inside the call. For files up to 50 MB the assistant gets a one-time upload URL and sends the file with curl.
Can the assistant spend all my credits?
It must state the exact price for each generation, and you can connect with Read only. Revoke the connection any time.