# Placeholder Image Generator — REST API endpoint `placeholder-image-generator`

Generate a placeholder image as an SVG string: a solid background with centred bold text (the dimensions by default, or custom text) and a thin border. Returns the SVG, a data: URL for it, and the computed font size. Sizes up to 4000x4000; the page's presets are available by name.

- Category: generators
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/placeholder-image-generator/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/placeholder-image-generator/
- Same tool on the other surface: https://findutils.com/mcp/placeholder-image-generator/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/placeholder-image-generator/execute \
  -H "Content-Type: application/json" \
  -d '{
    "width": 800,
    "height": 600,
    "text": "Hello"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/placeholder-image-generator
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `width` | integer | no | Image width in pixels (1-4000). Default 800. Default: `800`. |
| `height` | integer | no | Image height in pixels (1-4000). Default 600. Default: `600`. |
| `preset` | string (Square \| HD 720p \| Full HD \| Instagram Post \| Instagram Story \| Facebook Cover \| Twitter Post \| YouTube Thumbnail \| Banner (728x90) \| Leaderboard (970x250)) | no | A named size preset. When given, it replaces width and height. |
| `bg_color` | string | no | Background colour as #rgb or #rrggbb. Default "#e2e8f0". Default: `"#e2e8f0"`. |
| `text_color` | string | no | Text and border colour as #rgb or #rrggbb. Default "#64748b". Default: `"#64748b"`. |
| `text` | string | no | Custom text. Default: "<width> × <height>". |

Example arguments (verified):

```json
{
  "width": 800,
  "height": 600,
  "text": "Hello"
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Then ask the client to call `findutils:placeholder_image_generator`. Full MCP reference: https://findutils.com/mcp/placeholder-image-generator/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt