# Identicon and avatar generator

Turn any name, email or ID into a unique avatar: a symmetric 5×5 identicon or coloured initials, as SVG.

- Endpoint: `POST https://setget.net/v1/tools/identicon` with JSON `{"input": {...}}`
- MCP: `run_tool` with `slug` = `identicon`
- Page: https://setget.net/tools/identicon

## Inputs

- `text` (required, string): The name, email address or ID to draw. The same text always gives the same image.
- `style` (optional, string, one of `blocks`, `initials`, default `"blocks"`): blocks draws a symmetric pattern; initials draws one or two letters.
- `size` (optional, integer, default `240`, range 16..2000): Width and height in pixels.
- `shape` (optional, string, one of `square`, `rounded`, `circle`, default `"rounded"`): Outline of the image.
- `background` (optional, string): Background colour. Defaults to light grey for blocks and the generated colour for initials.

## Example 1: A block identicon

```json
{"input":{"text":"sam.rivera@example.com"}}
```

## Example 2: Initials in a circle

```json
{"input":{"text":"Sam Rivera","style":"initials","shape":"circle","size":96}}
```

**Is it the same as a GitHub identicon?** It is the same idea (a hash drawn as a mirrored 5×5 grid) but not the same picture. It is stable here: one text always gives one image.

**How are initials chosen?** The first letters of the first two words. For an email address only the part before @ is used.
