beatra
Sign in

How to add image generation to Claude Code with MCP

Install the Beatra Skill in Claude Code. It connects Claude Code to the Beatra MCP server and runs the sign-in, a one-time approval in your browser, so the image tools are ready right away. Ask for text-to-image, image-to-image, or targeted edits, up to 4 PNG images per request.

Updated

Set it up in your agent

Install the Beatra Skill once. The steps are the same for every task on this site.

Send this to your agentSign in once the first time

Install Beatra and tell me when I need to sign in: https://beatra.ai/install.md

Claude Code

  1. Send Claude Code the install message above.
  2. Or run claude plugin marketplace add beatra-ai/ai-media-generator-skill, then claude plugin install beatra@ai-media-generator-skill.
  3. When Claude Code shows a sign-in link, open it, sign in, and click Allow.

Codex

  1. Send Codex the install message above.
  2. Or run codex plugin marketplace add beatra-ai/ai-media-generator-skill, then codex plugin add beatra@ai-media-generator-skill.
  3. When Codex shows a sign-in link, open it, sign in, and click Allow.

Cursor

  1. Send the install message above in Cursor's agent chat.
  2. When the agent shows a sign-in link, open it, sign in, and click Allow.

Other agents

  1. Send the install message above to any agent that can install a Skill and run scripts.
  2. When the agent shows a sign-in link, open it, sign in, and click Allow.

Then ask in plain words, for example:

Generate four 1:1 icon options for a note-taking app, flat style, blue and white.
Edit hero.png: replace the sky with a clear sunset and keep everything else.

Tested agents and install methods →

How the connection works

The Beatra MCP server is https://mcp.beatra.cn/mcp over streamable HTTP, and it signs in with a device code. The Skill runs that sign-in and keeps the credential in ~/.beatra, so you never handle tokens. To connect your own MCP client, follow the MCP setup in the docs.

What you get

  • Text-to-image, image-to-image, and targeted edits.
  • Up to 4 images per request, up to 16.8 megapixels on the largest models.
  • Input images: up to 4 per request, as BMP, GIF, JPEG, PNG, TIFF, or WEBP.
  • Output: PNG.

Limits depend on the model. Figures as of ; the live model list is always current.

Live model list

Price

Installing is free. Each render uses Beatra credits, and new accounts start with free credits. Plans are on the pricing page, and the price of each model is in the live model list.

Pricing →Live model list

Skills for this task

The Beatra Skill covers everything on this page. These Skills add a ready-made workflow for one task:

Questions

Does this work in Codex and Cursor too?

Yes. The same Skill installs in Codex and Cursor with the steps above, and the image tools work the same way.

Can I see every MCP tool and its arguments?

Yes. The MCP tool reference in the docs lists every tool, its arguments, what it returns, and whether it uses credits.

Where do the images go?

They come back into your Claude Code conversation and are saved on the Work page of the Beatra console.

More use cases