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 DiceBear avatar SVG URL for a given style and seed string. Returns the URL that renders the avatar inline.

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 DiceBear avatar styles.

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");