DiceBear

liveDeveloper

Generate deterministic avatar SVGs in various styles via DiceBear v7

2tools
0msauth
free tier50 calls/day

Tools

generate_avatarrequired: style, seed

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
NameTypeDescription
stylereqstringThe avatar style to use. Available styles: adventurer, avataaars, bottts, fun-emoji, identicon, initials, lorelei, micah, miniavs, notionists, open-peeps, personas, pixel-art, thumbs.
seedreqstringA seed string that determines the avatar appearance. Same seed + style always produces the same avatar.
▶Try it
list_styles

List all available avatar styles. Returns style names and descriptions—use with generate_avatar to pick a style.

No parameters required.

▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/dicebear/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/dicebear/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"generate_avatar","arguments":{"style": "example", "seed": "example"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("generate_avatar", {"style":"example","seed":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("generate deterministic avatar svgs in various styles via dicebear v7");