retro-diffusion-pixel-art

Generate authentic, grid-aligned pixel art — sprites, characters, animations, and tilesets — from any MCP client.

CommunityOnlineNo 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.

How to connect

How to connect retro-diffusion-pixel-art to Claude

The server address to paste into Claude settings:

https://retro-diffusion-pixel-art--astropulse.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect retro-diffusion-pixel-art to ChatGPT

The server address to paste into ChatGPT settings:

https://retro-diffusion-pixel-art--astropulse.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect retro-diffusion-pixel-art to Cursor

The server address to paste into Cursor settings:

https://retro-diffusion-pixel-art--astropulse.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (17)

Raw names from tools/list. Only developers need these.

authenticateAuthenticate this MCP session with a RetroDiffusion public API key.
logoutClear the authenticated RetroDiffusion API key for this MCP session.
create_user_styleCreate 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_styleUpdate 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_styleDelete a user style using /v1/styles/{style_id}. style_id can be either internal id or prompt_style/public_id.
list_available_stylesList 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_modelsReturn unique public model identifiers available in /v1/styles/selector.
get_style_usageExplain 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_balanceGet credits/balance using the public /v1/inferences/credits endpoint.
estimate_inference_costEstimate 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_inferenceGenerate 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_toolsList 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_toolRun 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_costValidate an edit-tool request and estimate its cost and duration without running it. Always free.
start_inference_jobStart 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_jobCheck 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_statusCheck RetroDiffusion subsystem health (/v1/status, no auth). Useful before bulk generation runs.