Developers

Quick start

Replace YOUR_KEY and CROWD_ID with real values.

JavaScript (fetch)

const res = await fetch('https://www.genjicrowd.com/v1/crowd/CROWD_ID', {
  headers: { 'Authorization': 'Bearer YOUR_KEY' }
});
const data = await res.json();
console.log(data.characters.length, 'characters');
// data.assets.skeleton_glb -- load this GLB once
// data.characters[]        -- per-character part assignments + transforms

curl

curl https://www.genjicrowd.com/v1/crowd/CROWD_ID \
  -H "Authorization: Bearer YOUR_KEY"

Python (requests)

import requests

r = requests.get(
    'https://www.genjicrowd.com/v1/crowd/CROWD_ID',
    headers={'Authorization': 'Bearer YOUR_KEY'}
)
data = r.json()
print(len(data['characters']), 'characters')
skeleton_url = data['assets']['skeleton_glb']

{
  "crowd_id": "cr_xxxxxxxx",
  "name": "My Scene",
  "recipe": { /* layout, size, weights, obstacles... */ },
  "characters": [
    { "body": "M_Terracotta_Infantry_Soldier",
      "face": "M_Chinese_Face_01",
      "hair": "Ming_Warrior_Crown",
      "position": [x, y, z],
      "rotation": radians,
      "scale": 1.0 }
  ],
  "assets": {
    "skeleton_glb": "https://...",
    "animations": { "idle": "https://...", "walk": "https://..." }
  }
}

MCP server config

Genji's MCP server is remote-hosted, so no install is needed. Add this to your claude_desktop_config.json (or equivalent MCP config file), using one of your API keys from the Keys tab:

{
  "mcpServers": {
    "genji": {
      "url": "https://www.genjicrowd.com/mcp",
      "headers": {
        "Authorization": "Bearer gk_live_xxxxxxxxxxxx"
      }
    }
  }
}

Available tools