Skip to content

MCP server · Open source

Claude can make images now

Give Claude Code, Claude Desktop or Cursor 85 image and video models. One command.

claude mcp add imference -e IMFERENCE_API_KEY=your-key -- npx -y imference-mcp
{
  "mcpServers": {
    "imference": {
      "command": "npx",
      "args": ["-y", "imference-mcp"],
      "env": { "IMFERENCE_API_KEY": "your-key" }
    }
  }
}
Get an Imference key GitHub Free server · from $0.003 per image

A violinist under a pine tree at night. Pick the best model.

● list_models

● get_model("krea-2-turbo")

● generate(format: "portrait")

A violinist under a pine tree at night, made with Krea 2 Turbo
Krea 2 Turbo$0.008

Krea 2 Turbo is great with moody light, so I used it. Want a wider frame?

Claude CodeClaude DesktopCursorWindsurfAny MCP client

How it works

It doesn't just call "generate"

A cover for my post about night trains

1

You ask in plain words

No prompt tricks, no model names.

Z-Image Turbo
IntoRealism Krea 2
Hassaku (Anima)

2

It picks the right model

Every model has a card: style, prompt format, price.

✓ Matches the brief

3

It looks, then fixes

The image comes back into the chat. If it missed, it tries again.

Tools

Eleven tools, no glue code

  • list_modelsBrowse the catalog
  • get_modelRead a model's card
  • list_formatsSquare, portrait, wide
  • generateMake it, see it
  • check_statusFollow a video job
  • download_mediaSave to a file
  • list_mediaPast generations
  • get_balanceCredits left
  • wallet_balanceUSDC in the wallet
  • payment_configRails, caps, spend
  • Full reference on GitHub

Paying

An Imference key, or a wallet with a cap

Imference key

Prepaid credits

Top up by card or in crypto. One balance for Claude, the desktop app and Imference Web.

IMFERENCE_API_KEY=your-key
Get an Imference key

x402 wallet

No account at all

The agent pays each image in USDC on Base. Capped per payment and per session.

IMFERENCE_WALLET_PRIVATE_KEY=0x…
IMFERENCE_X402_MAX_USD=2
How x402 works

The catalog

What your agent can pick from

All 85 models

FAQ

Questions

Can Claude generate images?

Not by itself. Claude has no image model built in. With the Imference MCP server it calls a model from the catalog, sees the result in the chat and refines it.

Which apps does it work with?

Claude Code, Claude Desktop, Cursor and any other MCP client. You need Node.js 20.10 or newer, or Imference Desktop, which sets it all up for you.

Can it run on my own GPU?

Yes, with Imference Desktop open. The server generates and edits on your computer for free, with the models you downloaded, and every run shows up in the app. It falls back to the cloud only when Desktop can't run the request, and never retries a failed local run as a paid one.

How much does it cost?

The server is free and MIT licensed. Runs on your own GPU with Imference Desktop are free. In the cloud, you pay per image, at the price each model shows. No subscription.

Do I need an account?

No. Buy an Imference key without signing up, or let the agent pay per image from a wallet with x402.

It doesn't start the first time

npx downloads the package on first run and some clients time out. Install it once with npm i -g imference-mcp and use imference-mcp as the command.

Give Claude a paintbrush