---
title: "Generate a placeholder image (SVG)"
method: POST
path: "/v1/tools/placeholder_image"
---

# Generate a placeholder image (SVG)

`POST /v1/tools/placeholder_image`

## Request

- Base URL: `https://mcp.cleanor.app`
- URL: `https://mcp.cleanor.app/v1/tools/placeholder_image`
- Auth: none declared

Generate a lightweight SVG placeholder image at any size, with an optional label and custom background/text colors. Dependency-free, pastes straight into a page or mockup. Use for wireframes and design stubs instead of hotlinking a placeholder service.

## Request body

- object
  - `width` integer: Width in pixels.
  - `height` integer: Height in pixels.
  - `bg` string: Background color (hex, rgb() or hsl()).
  - `color` string: Text color.
  - `text` string: Label text. Defaults to the dimensions, e.g. "600×400".

## Response `200`

Tool result: `data` (structured) and `text` (human-readable).

- ToolResult
  - `ok` boolean
  - `tool` string
  - `data` object, nullable
  - `text` string
  - `attribution` string

## Other responses

- `400`: Invalid arguments.
- `429`: Rate limited (120 requests per minute per IP).

---

[API](https://skmtc.dev/cleanor/apis/cleanor-api.md) · [All operations](https://skmtc.dev/cleanor/apis/cleanor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cleanor/apis/cleanor-api/revisions/5f7be54e7a84?raw)