@prometheusavatar/mcp-server

Give any AI agent an embodied Live2D avatar via Model Context Protocol.

npx @prometheusavatar/mcp-server

9 Tools

| Tool | Description | |------|-------------| | create_avatar | Initialize a new avatar instance with model, voice, and persona | | equip_asset | Equip/unequip marketplace assets (skins, voices, effects, etc.) | | generate_asset | AI-generate new assets from text prompts (persona, expression, scene, etc.) | | update_asset | Edit price, name, description, tags, or license of an existing marketplace asset | | generate_image_pro | NEW v0.3 AAA-quality image gen via gpt-image-1 (skin preview cards / posters / UI mocks / XHS carousels) · BYOK OpenAI · Free quota · Pro Credits · Gemini fallback | | list_marketplace | Browse available marketplace assets by category | | get_avatar_status | Get current avatar state and equipped assets | | share_avatar | Generate shareable links and embed codes | | speak | Make the avatar speak text with TTS and lip-sync animation |

Setup

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "prometheus": {
      "command": "npx",
      "args": ["-y", "@prometheusavatar/mcp-server"],
      "env": {
        "GEMINI_API_KEY": "your-key-here"
      }
    }
  }
}

Cursor / Windsurf / Any MCP Client

{
  "command": "npx",
  "args": ["-y", "@prometheusavatar/mcp-server"]
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | GEMINI_API_KEY | For generate_asset | Google AI API key (free) | | OPENAI_API_KEY | For generate_image_pro (BYOK) | OpenAI key with gpt-image-1 access (platform.openai.com) — without this, platform Free quota / Pro Credits routes apply | | PROMETHEUS_API_URL | No | Custom API URL (default: https://prometheus.mythslabs.ai) | | PROMETHEUS_API_KEY | No | API key for authenticated operations |

Example Conversation

User: "Create an avatar that looks like a cute anime girl and make her say hello"

AI Agent (using MCP):

1. Calls create_avatar → gets embed URL
2. Calls speak with "Hello! Nice to meet you! 😊"
3. Returns the embed URL to the user

User: "Browse the marketplace for cool effects"

AI Agent:

1. Calls list_marketplace with category "effects"
2. Presents Cherry Blossom Rain, Starfield, etc.
3. User picks one → calls equip_asset

User: "Generate a cyberpunk anime girl skin in AAA Genshin / Overwatch shop card tier"

AI Agent (v0.3+):

1. Calls generate_image_pro with { style: 'cyberpunk', task: 'aaa_skin', size: '1024x1536', quality: 'high', prompt: '3D cel-shaded engine render, cyberpunk anime girl, neon hair...' } (Twin Prompt-Is-The-Ceiling rule — recommend ≥100-word prompt with explicit AAA benchmark named for best quality)
2. Returns 1024×1536 base64 image (or publicUrl when upload: true) — ready to ship to marketplace as a skin preview card
3. Cost reported per call (Free quota / Pro Credits / BYOK $0)

Links

• Platform: prometheus.mythslabs.ai
• SDK: npm i @prometheusavatar/core
• GitHub: myths-labs/prometheus-avatar

License

MIT — Myths Labs