NamiFusion × your AI agent

Generate images and videos from Claude Code & Codex.

Your agent already understands the project. Give it the tools to create the visuals—with NamiFusion MCP.

Claude Code CodexRemote MCP · Streamable HTTP
Cinematic visual inspiration: a figure beneath a flock of birds at sunset
Visual inspiration · example image

Example agent workflow

“Create a cinematic image for my next project.”

Claude Code / CodexNamiFusion MCP
  1. 01generation_list_models
  2. 02generation_create_task
  3. 03task_wait output URL

Start with an idea.
Keep working in your agent.

Try these starter prompts after connecting. Model availability and generation costs vary.

01 / Creative assets

Make the image your project needs.

Stay with your code or creative brief while your agent finds a model and creates an asset.

“Use NamiFusion to find an image model and generate a 16:9 editorial illustration of a quiet coastal town at sunrise. Return the output URL and the model used.”

Generation MCP

02 / From still to motion

Turn a reference into a video.

Give your agent an accessible image URL and a motion brief. It can inspect model inputs and track the task.

“Find a NamiFusion image-to-video model. Use my image URL as the reference, add a slow camera push-in, and use a duration the model supports. Run one video and return the result.”

Marketplace MCP

03 / Connected production

Keep the whole project in view.

Use the same saved canvas for visual planning and agent-assisted changes, with explicit node dependencies.

“Inspect my saved NamiFusion workflow WORKFLOW_ID. Summarize its assets and dependencies, then prepare an image-to-video branch using the available generation forms. Return the updated canvas cursor before generation.”

Workflow MCP

One account. Three connections.

Give your agent the tools it needs.

01 / Generation MCP

Generate media

Turn a prompt into images, video, or audio. Submit face swaps, follow task progress, and retrieve the finished output.

https://www.namifusion.com/api/v1/task/mcp/
02 / Marketplace MCP

Run model APIs

Search the model catalog, inspect each model’s inputs, and call its API through the same agent conversation.

https://www.namifusion.com/api/v1/marketplace/mcp/
03 / Workflow MCP

Work on a canvas

Read and edit your saved canvas, connect assets to image and video nodes, and generate selected nodes or groups.

https://www.namifusion.com/api/v1/workflow/mcp/

A few lines. A new capability.

Connect NamiFusion
to your agent.

  1. 1

    Create your API key

    Sign in to NamiFusion and create a dedicated key on the API Keys page.

  2. 2

    Add the connection

    Choose your client and service. Copy the setup, replace the placeholder locally, and run it in your terminal.

  3. 3

    Ask for what you want to make

    Open your agent, check that NamiFusion tools are available, and try a starter prompt.

Create an API key

Have another MCP client? The integration guide includes HTTP authentication, Gemini CLI, and a local bridge option.

Terminal · Claude Code

export NAMIFUSION_API_KEY='sk-YOUR_API_KEY'

claude mcp add --transport http namifusion-generation \
  https://www.namifusion.com/api/v1/task/mcp/ \
  --header "Authorization: Bearer $NAMIFUSION_API_KEY"

Replace sk-YOUR_API_KEY in your own terminal. Keep your key private.

Start here for image and video generation. Your agent discovers available models before submitting a task.

Claude Code saves the configured header in its local MCP configuration. Repeat for any other service you need. Full integration guide ↗

Before you connect

A few useful answers.

What can Claude Code or Codex do with NamiFusion MCP?

They can discover models, generate images, videos and audio, run face-swap tasks, retrieve results, and read or edit saved workflow canvases. Connect the Generation, Marketplace, or Workflow service for the capabilities you need.

Do I need to host an MCP server?

No. NamiFusion provides remote MCP servers over Streamable HTTP. Create a NamiFusion API key, add a service URL to your client, and send the key in a Bearer authentication header.

Does this setup work with the Claude desktop app or ChatGPT connectors?

The setup on this page is for Claude Code and Codex. Other clients need support for Streamable HTTP with a custom authentication header, or a compatible local bridge. A Claude desktop or ChatGPT connector that requires an OAuth flow is not covered by this API-key setup.

How are generations billed?

Generation and model runs consume NamiFusion credits according to the selected model and inputs. Usage and model charges still apply when you connect an agent. Check current model pricing and your account balance before running tasks.

Can my agent use local images or video files?

Yes, when the client can upload files over HTTP. Generation MCP provides a signed upload URL. Workflow MCP provides a multipart upload flow that creates a durable asset. The client transfers the file bytes directly to storage, then references the uploaded media in its tool calls.

What should I know before using Workflow MCP?

Start with a saved workflow, or create one with workflow_create. The agent reads saved canvas state and uses the current cursor when making changes. Workflow generation requires an API key without a model allow-list or monthly quota; workflow calls do not increment per-key usage counters. The integration guide explains the authoring and generation flow.

Your next creation can start here.

Explore the models, the canvas, and the ways to connect.