`generate_avatar`

Pack: dicebear · Endpoint: https://gateway.pipeworx.io/dicebear/mcp

Generate a custom avatar SVG. Specify a style (e.g., ‘avataaars’, ‘pixel-art’, ‘lorelei’) and seed (e.g., username). Returns the SVG URL ready to display.

Parameters

Name	Type	Required	Description
`style`	string	yes	The avatar style to use. Available styles: adventurer, avataaars, bottts, fun-emoji, identicon, initials, lorelei, micah, miniavs, notionists, open-peeps, personas, pixel-art, thumbs.
`seed`	string	yes	A seed string that determines the avatar appearance. Same seed + style always produces the same avatar.

Example call

Arguments

{
  "style": "avataaars",
  "seed": "john_doe"
}

curl

curl -X POST https://gateway.pipeworx.io/dicebear/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_avatar","arguments":{"style":"avataaars","seed":"john_doe"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('generate_avatar', {
  "style": "avataaars",
  "seed": "john_doe"
});

More examples

{
  "style": "pixel-art",
  "seed": "user123"
}

Response shape

Always returns: style, seed, url, format

Field	Type	Description
`style`	string	The avatar style that was used
`seed`	string	The seed string that determines avatar appearance
`url`	string	The SVG URL for the generated avatar
`format`	string	The format of the avatar (always SVG)

Full JSON Schema

{
  "type": "object",
  "properties": {
    "style": {
      "type": "string",
      "description": "The avatar style that was used"
    },
    "seed": {
      "type": "string",
      "description": "The seed string that determines avatar appearance"
    },
    "url": {
      "type": "string",
      "description": "The SVG URL for the generated avatar"
    },
    "format": {
      "type": "string",
      "enum": [
        "svg"
      ],
      "description": "The format of the avatar (always SVG)"
    }
  },
  "required": [
    "style",
    "seed",
    "url",
    "format"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "dicebear": {
      "url": "https://gateway.pipeworx.io/dicebear/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

generate_avatar