retro-diffusion-pixel-art
Generate authentic, grid-aligned pixel art — sprites, characters, animations, and tilesets — from any MCP client.
Community: Submitted by a user or imported; check the owner before granting accessOnlineNo sign-inGlobalFreeRead-only
What it can do
- Authenticate: Authenticate this MCP session with a RetroDiffusion public API key.
- Logout: Clear the authenticated RetroDiffusion API key for this MCP session.
- Create User Style: Create a user style from the public RD Pro template using /v1/styles. Use `style_reference_images` and `style_reference_caption` for style-level references. These are baked into the
What data it sees
Do you need an account
No: the server works without sign-in
Generate authentic, grid-aligned pixel art — sprites, characters, animations, and tilesets — from any MCP client. 90+ styles, free cost estimation, pay-per-generation with no subscription and credits that never expire.
Server tool list (17)
Raw names from tools/list. Only developers need these.
| authenticate | Authenticate this MCP session with a RetroDiffusion public API key. |
| logout | Clear the authenticated RetroDiffusion API key for this MCP session. |
| create_user_style | Create a user style from the public RD Pro template using /v1/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`. |
| update_user_style | Update a public RD Pro user style using /v1/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`. |
| delete_user_style | Delete a user style using /v1/styles/{style_id}. style_id can be either internal id or prompt_style/public_id. |
| list_available_styles | List publicly available styles from /v1/styles/selector. Use this to discover valid prompt_style values plus style metadata such as require_input_image and supports_reference_images. |
| list_available_models | Return unique public model identifiers available in /v1/styles/selector. |
| get_style_usage | Explain 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`. |
| get_balance | Get credits/balance using the public /v1/inferences/credits endpoint. |
| estimate_inference_cost | Estimate generation cost using the public /v1/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. |
| create_inference | Generate images using the public /v1/inferences endpoint. For the highest quality prefer RD Pro styles (rd_pro__*); they support reference_images for character/style consistency. For animation styles prefer start_inference_job + get_inference_job instead — animations are long-running. 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. |
| list_edit_tools | List the enabled canvas edit tools from /v1/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. |
| run_edit_tool | Run a canvas edit tool on an image via /v1/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. |
| estimate_edit_tool_cost | Validate an edit-tool request and estimate its cost and duration without running it. Always free. |
| start_inference_job | Start a generation as an async job (POST /v1/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. |
| get_inference_job | Check 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_service_status | Check RetroDiffusion subsystem health (/v1/status, no auth). Useful before bulk generation runs. |