Retro Diffusion Pixel Art MCP server
online · 100% uptimeai.retrodiffusion/pixel-art·v1.1.0·5 starsGenerate authentic pixel art - sprites, animations, and tilesets - from any MCP client
5 stars
Reviews
Write oneNobody has reviewed Retro Diffusion Pixel Art yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Retro Diffusion Pixel Art tools (33, 6 write)
write = sends, deletes, buys or postsauthenticateFreeAuthenticate this MCP session with a RetroDiffusion public API key.
create_inferencewrite actionFreeGenerate images using the public /v2/inferences endpoint. For the highest quality prefer RD Pro styles (rd_pro__*); they support reference_images for character/style consistency, and most go as small as 12x12 px (check list_available_styles for each style's limits) — a small target size is never a reason to switch to a cheaper model family. Style ids are opaque strings with no uniform format (some RD Fast styles appear as "default:rd_flux"); take them verbatim from the catalog and never infer capabilities from an id's prefix. For animation styles prefer start_inference_job + get_inference_job instead — animations are long-running, and a failed animation is worth one retry with identical parameters (failures auto-refund). Field-tested workflow rules: N distinct items = N individually usable images (separate calls or num_images=N), never one sheet/grid image unless a sheet IS the deliverable. Variants of ONE image (seasons, day/night, palettes) = generate the base once, then derive each variant with the image_edit tool ("... keep the exact same composition") — independent generations of the "same" scene come out unrelated. Converting an existing image INTO pixel art is rd_pro__pixelate with input_image (16-256 px output, batch<=16); reference_images-based generation re-imagines rather than converts. To animate an image you already have, use rd_advanced_animation__* with input_image (fixed-format rd_animation__* styles generate their own subject from the prompt instead). To get the other directional views of a sprite you already have, use rd_advanced_animation__rotate with input_image (same 8-direction layout as rd_animation__8_dir_rotation). Use `input_image` for the main source image, `reference_images` for extra per-inference guidance, and `style_reference_images` only on create_user_style/update_user_style. The response excludes raw base64 image payloads to keep MCP outputs compact.
create_user_stylewrite actionFreeCreate a user style from the public RD Pro template using /v2/styles. Use `style_reference_images` and `style_reference_caption` for style-level references. These are baked into the custom style and are not the same as per-inference `reference_images`.
delete_lowpoly_animationwrite actionFreeDelete one animation from a Low-Poly model's version (free) and return the model. The rig stays, so animating again needs no new rig. This cannot be undone.
delete_user_stylewrite actionFreeDelete a user style using /v2/styles/{style_id}. style_id can be either internal id or prompt_style/public_id.
estimate_edit_tool_costFreeValidate an edit-tool request and estimate its cost and duration without running it. Always free.
estimate_inference_costFreeEstimate generation cost using the public /v2/inferences endpoint with check_cost=true. Use `input_image` for the main source image, `reference_images` for extra per-inference guidance, and `style_reference_images` only on create_user_style/update_user_style.
estimate_lowpoly_costFreePrice a Low-Poly job without starting it (free). For generate with size auto, returns the size auto would pick.
export_lowpoly_modelFreeExport a Low-Poly model for an engine or tool and return a hosted download URL (free). Engines (Godot, Unity, Unreal, three.js) and Blender get .glb; Blockbench gets .bbmodel; Minecraft gets a resource pack; .glb and .bbmodel include every animation. Animated GIFs, sprite sheets and MP4 videos need an animation name from the model.
fix_pixel_artFreeRecover the native pixel grid from enlarged, softened, AI-rendered, or compressed pixel art. Standard uses the native Rust detector. Neural uses the neural reconstruction engine and accepts optional target width and height values. This repairs existing art—it does not generate a new image. Both engines are free and share a limit of 10 requests per minute per API token. Provide exactly one source as base64 input_image or a public HTTPS image_url. URL input avoids the ALB request-body limit. Decoded images may contain up to 16 megapixels. Successful response JSON is limited to 850,000 bytes for AWS ALB compatibility.
get_balanceFreeGet credits/balance using the public /v2/inferences/credits endpoint.
get_inference_jobFreeCheck the status of an async generation started with start_inference_job. Statuses: pending, running, succeeded, failed. On success the result carries hosted output_urls (raw base64 payloads are excluded to keep MCP outputs compact).
get_inference_resultFreeRetrieve retained outputs for a synchronous generation. Use the request_id returned by create_inference to recover or refresh signed output URLs. This lookup is read-only; never repeat a paid create_inference call just because delivery URLs are temporarily missing.
get_lowpoly_jobFreeStatus of a Low-Poly job: pending, running, succeeded or failed. On success, the model with its versions, render URLs and animations. Poll every 10-20 seconds; jobs take minutes.
get_lowpoly_modelFreeA Low-Poly model: status, versions (render URLs, animations) and any running job.
get_lowpoly_pricingFreeLow-Poly (3D) sizes, prices per operation (generate / revise / animate), styles, limits and export targets. Free.
get_service_statusFreeCheck RetroDiffusion subsystem health (/v2/status, no auth). Useful before bulk generation runs.
get_style_usageFreeExplain how to use a public prompt_style from the RetroDiffusion API. Use this before create_inference if you are unsure whether a style expects `input_image`, supports per-inference `reference_images`, or whether you meant style-level `style_reference_images`.
list_available_modelsFreeReturn unique public model identifiers available in /v2/styles/selector.
list_available_stylesFreeList publicly available styles from /v2/styles/selector. Use this to discover valid prompt_style values plus style metadata such as require_input_image and supports_reference_images.
list_edit_toolsFreeList the enabled canvas edit tools from /v2/edit/tools with their fields, costs, and limits. Edit tools are the recommended way to post-process generated pixel art: background removal, palette conversion, color reduction, pixel correction, rotation, inpainting, outpainting, seam tiling, and prompt-driven edits.
list_inference_jobsFreeList your most recent async jobs, newest first (GET /v2/inferences/tasks). Recovery path: if a submission response was lost (timeout, disconnect) before the task_id arrived, the job was still accepted — find it here instead of re-submitting and being charged twice. Then poll it with get_inference_job.
list_lowpoly_modelsFreeThe account's Low-Poly models, newest first.
logoutFreeClear the authenticated RetroDiffusion API key for this MCP session.
recolor_lowpoly_modelFreeRecolor a Low-Poly model's textures with the image color tools and save the result as a new version (returns the model). Color Reducer and Palette Converter are free; Color Style Transfer costs $0.01. Later revisions and animations keep the new colors.
run_edit_toolwrite actionFreeRun a canvas edit tool on an image via /v2/edit/tools/{tool_id}. Free tools: color_reducer, palette_converter, pixel_correction, k_centroid_downscale, rotate. $0.01 tools: background_remover, color_style_transfer. Premium ($0.18): image_edit, inpainting, outpainting, seam_tiling. Use estimate_edit_tool_cost first for anything that charges — estimation is free. The edited image is returned in base64_images.
start_inference_jobFreeStart a generation as an async job (POST /v2/inferences with async=true) and return a task_id. Recommended for advanced animations (rd_advanced_animation__*), other animation styles, and batches — they run for tens of seconds and can outlive a synchronous MCP call. Poll the returned task_id with get_inference_job roughly every 2-5 seconds.
start_lowpoly_animateFreeAdd an animation to a Low-Poly model version, or change an existing one by passing its name as animation (paid, priced by size). The first animation rigs the model for free. Animations attach to the version; they do not create a new version. Poll get_lowpoly_job(task_id).
start_lowpoly_generateFreeStart building a low-poly 3D model with pixel-art textures from a prompt and/or reference images (paid). Optional input_palette (a palette image, as for create_inference): the model uses only its colors, and revisions and animations keep them. Returns task_id and asset_id immediately; poll get_lowpoly_job(task_id) until it succeeds (usually 1-5 minutes). Then use export_lowpoly_model for .glb/.bbmodel/Minecraft/OBJ files, start_lowpoly_revise to change it, or start_lowpoly_animate to add motion. Failed jobs are refunded automatically; never restart a running job.
start_lowpoly_rerigFreeRebuild the skeleton of a rigged Low-Poly model version (paid, priced by size), e.g. to move a pivot or add bones. The version is updated in place; animations whose bones the new rig still has are kept. Versions without a rig are rigged for free by their first animation instead. Poll get_lowpoly_job(task_id).
start_lowpoly_reviseFreeChange an existing Low-Poly model (paid, priced by its size). The result is saved as a new version. Poll get_lowpoly_job(task_id). One job per model at a time.
start_lowpoly_splitFreeBreak a Low-Poly model into separate models (paid, priced by its size): a desk scene becomes the desk, a candle, each book, and so on. Each piece is a new model (and history item) facing the front, with its own textures, rig and animations; the original is unchanged. Poll get_lowpoly_job(task_id); its pieces list the new models.
update_user_stylewrite actionFreeUpdate a public RD Pro user style using /v2/styles/{style_id}. Use `style_reference_images` and `style_reference_caption` for style-level references. These are baked into the custom style and are not the same as per-inference `reference_images`.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 816ms20/20
- Tool poisoning33 tool descriptions checked15/15
- Auth qualityAPI key sent as a header8/15
- Maintenancelast push 23 days ago15/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace8/10
How Retro Diffusion Pixel Art compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 88/100
- higher than 75% of 48,255 servers
- Tools
- 33
- the typical server has 7
- Tools that change things
- 18%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote server answers 100%
- Response time
- 128 ms
- faster than 78% of 30,031 servers
- GitHub stars
- 5
- more than 83% of 28,688 servers
What its tools let an agent do: 21 read · 2 create · 1 change · 2 delete · 7 run or deploy
Install Retro Diffusion Pixel Art in Claude Code, Cursor or VS Code
claude mcp add --transport http pixel-art https://mcp.retrodiffusion.ai/mcp
What the publisher says
From the Retro Diffusion Pixel Art repository's README, as published. We do not edit it. Read it on GitHub
Retro Diffusion MCP Server
Generate real pixel art — sprites, characters, animations, and tilesets — from any MCP-capable AI assistant. Grid-aligned pixels, controlled palettes, transparent backgrounds. Not "pixel-art style" images. The real thing.
Website · API Docs · API Examples · Discord
This is a hosted, remote MCP server — nothing to install or run locally. Point your client at the endpoint, add your API key, and your assistant can browse 90+ pixel art styles, estimate costs for free, generate game-ready art, and repair enlarged or softened pixel art.
Endpoint: https://mcp.retrodiffusion.ai/mcp (Streamable HTTP)
Auth: Authorization: Bearer <your API key> (keys start with rdpk-)The hosted MCP endpoint remains backward compatible and defaults to Retro Diffusion API v2. Its server-side version policy is described in API compatibility; MCP clients do not change their endpoint or authentication settings.
Get an API key (2 minutes)
- Create a free account at retrodiffusion.ai — new accounts include free starter credits.
- Open Developer Tools and click Create API Key.
Pricing is pay-per-generation (from ~$0.01 per image), prepaid, no subscription, and credits never expire. Cost estimation is always free, so your agent can check the price of anything before spending.
Setup by client
Claude Code
claude mcp add --transport http retro-diffusion https://mcp.retrodiffusion.ai/mcp \
--header "Authorization: Bearer rdpk-YOUR-KEY"Or install the plugin (bundles the server plus a pixel-art workflow skill):
/plugin marketplace add Retro-Diffusion/retro-diffusion-mcp
/plugin install pixel-art@retro-diffusionCursor
Click the Add to Cursor badge above, then replace YOURAPIKEY — or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"retro-diffusion": {
"url": "https://mcp.retrodiffusion.ai/mcp",
"headers": { "Authorization": "Bearer rdpk-YOUR-KEY" }
}
}
}VS Code (GitHub Copilot)
Add to mcp.json (Command Palette → "MCP: Add Server" → HTTP):
{
"servers": {
"retro-diffusion": {
"type": "http",
"url": "https://mcp.retrodiffusion.ai/mcp",
"headers": { "Authorization": "Bearer rdpk-YOUR-KEY" }
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"retro-diffusion": {
"serverUrl": "https://mcp.retrodiffusion.ai/mcp",
"headers": { "Authorization": "Bearer rdpk-YOUR-KEY" }
}
}
}Claude Desktop
Use mcp-remote in claudedesktopconfig.json:
{
"mcpServers": {
"retro-diffusion": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.retrodiffusion.ai/mcp",
"--header",
"Authorization: Bearer rdpk-YOUR-KEY"
]
}
}
}Anything else
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Retro Diffusion Pixel Art: common questions
- Is Retro Diffusion Pixel Art MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the Retro Diffusion Pixel Art safety report
- How do I install Retro Diffusion Pixel Art?
- It runs remotely at mcp.retrodiffusion.ai. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Retro Diffusion Pixel Art need an API key?
- Yes. The registry entry asks for
Authorization. - Is Retro Diffusion Pixel Art maintained?
- The last commit was 63 days ago (2026-09-02). The latest release is v1.1.0.
- Is Retro Diffusion Pixel Art up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- How does Retro Diffusion Pixel Art compare with other MCP servers?
- safety score 88/100 (higher than 75% of 48,255 servers); tools 33 (the typical server has 7); tools that change things 18% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.