DiceBear

live Design

Generate deterministic avatar SVGs in various styles via DiceBear v7

2 tools

0ms auth

free tier 50 calls/day

Tools

generate_avatar required: style, seed

Generate a DiceBear avatar SVG URL for a given style and seed string. Returns the URL that renders the avatar inline.

Parameters

Name Type Description

style req string 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 req string A seed string that determines the avatar appearance. Same seed + style always produces the same avatar.

▶ Try it

Response

list_styles

List all available DiceBear avatar styles.

No parameters required.

▶ Try it

Response

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

Related packs

Other Pipeworx packs in the same categories (Design):

MCP Config

claude_desktop_config.json

{
  "mcpServers": {
    "pipeworx-dicebear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/dicebear/mcp"
      ]
    }
  }
}