# Avatar Generator — MCP tool `findutils:avatar_generator`

Make an avatar as an SVG from a name or an email address, with no external service. Initials mode draws up to two initials on a background colour derived from the input; identicon mode draws a mirrored 5×5 block pattern. Both are seeded from a SHA-256 of the trimmed, lower-cased input, so the same input always gives the same avatar. Returns the SVG, a data: URL, the colours and the initials or the grid.

- Category: generators
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, API key for tools/call, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/avatar-generator/execute (API key, 60 req/min per IP)
- API key: Running a tool needs an API key. Keys are not for sale yet: ask for early access. Without a key, a tool call answers HTTP 402 Payment Required with the error code PAYMENT_REQUIRED. The catalog and the schemas stay open without a key. https://findutils.com/api/#api-keys
- Reference page: https://findutils.com/mcp/avatar-generator/
- Same tool on the other surface: https://findutils.com/api/avatar-generator/

## Connect

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/ --header "Authorization: Bearer YOUR_API_KEY"
```

Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

## Call the tool (verified example)

```bash
curl -X POST https://mcp.findutils.com/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "avatar_generator",
      "arguments": {
        "text": "Ada Lovelace",
        "mode": "initials",
        "size": 128
      }
    }
  }'
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `text` | string | yes | The name or email address the avatar is made from (1-200 characters). Case and surrounding spaces do not change the result. |
| `mode` | string (initials \| identicon) | no | initials (default) or identicon. Default: `"initials"`. |
| `shape` | string (circle \| square) | no | circle (default) or square. Default: `"circle"`. |
| `size` | integer | no | Width and height of the SVG in pixels (16-1024). Default 256. The drawing scales without loss. Default: `256`. |
| `font` | string (inter \| jetbrains-mono) | no | Typeface of the initials: inter (default) or jetbrains-mono. Ignored in identicon mode. Default: `"inter"`. |

Example arguments (verified):

```json
{
  "text": "Ada Lovelace",
  "mode": "initials",
  "size": 128
}
```

## Also a REST endpoint

```bash
curl -X POST https://api.findutils.com/api/tools/avatar-generator/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Ada Lovelace",
    "mode": "initials",
    "size": 128
  }'

# Parameter schema (no key needed)
curl https://api.findutils.com/api/tools/avatar-generator
```

Full REST reference: https://findutils.com/api/avatar-generator/ · OpenAPI 3.1 spec: https://findutils.com/api/openapi.json

---
Full catalog: POST https://mcp.findutils.com/ with method `tools/list` · https://findutils.com/mcp/ · https://findutils.com/llms.txt