---
title: "Add text-to-image to Claude Code with an MCP server"
summary: "Install the Beatra Skill in Claude Code: it connects the Beatra MCP server and runs the sign-in, then generates and edits images, up to 4 PNGs per request."
url: "https://beatra.ai/en/use-cases/claude-code-image-mcp"
language: "en"
last_verified: "2026-11-09"
---

[Beatra](https://beatra.ai/en) · [Use cases](https://beatra.ai/en/use-cases)

# 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 2026-11-09

## Set it up in your agent

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

```text
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](https://beatra.ai/en/compatibility)

## How the connection works

The Beatra MCP server is `https://mcp.beatra.ai/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](https://docs.beatra.ai/en/docs/choose-integration#mcp).

## 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 2026-10-18; the live model list is always current.

[Live model list](https://docs.beatra.ai/en/docs/models)

## 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](https://beatra.ai/en/pricing) · [Live model list](https://docs.beatra.ai/en/docs/models)

## Skills for this task

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

- [AI Image Generation Studio](https://beatra.ai/en/skills/ai-image-generation-studio): Generate, compose, and edit product images, brand visuals, posters, social graphics, illustrations, and photo variations.

## 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

- [Text-to-video, image-to-video, and editing, 480p to 4K.](https://beatra.ai/en/use-cases/ai-video-generation)
- [Text-to-speech in 40 languages, preset or cloned voices.](https://beatra.ai/en/use-cases/ai-voiceover)
- [Songs with your lyrics, instrumentals, and background music.](https://beatra.ai/en/use-cases/ai-music-generation)
- [White-background shots, lifestyle scenes, and listing sets.](https://beatra.ai/en/use-cases/batch-product-images)
- [One install and one balance, compared with each model's API.](https://beatra.ai/en/use-cases/beatra-vs-model-apis)