Reference
The MCP server
Server URL: https://broen.tech/api/asmi/mcp. Authentication is
Authorization: Bearer <USER_MCP_API_KEY> OR x-api-key: <USER_MCP_API_KEY> — whichever header your MCP client exposes.
Fully compliant with MCP spec 2025-06-18, RFC 9728 protected
resource metadata, and RFC 8707 resource indicators. Works with
Claude Code, Claude Desktop, Cursor, Windsurf, Zed, Cline, Lovable,
v0, ChatGPT Developer Mode, Replit, and every other MCP client
we've seen.
Tools exposed (src/lib/asmi/mcp/tools.ts):
| Tool | Purpose |
|---|---|
list_avatars | List the user's deployed avatars (optional status + search filters). |
get_avatar | Full sanitized AvatarDefinition. Base64 image data is replaced with per-expression API URLs to keep the payload small. |
get_avatar_markdown | Same definition in human-readable Markdown. |
get_avatar_assets | Expression image URLs + animation metadata (frame count, hold / transition durations, license). |
test_avatar | Run a single conversation turn server-side (design-time only). |
dispatch_event | Emit a named event (WIDGET_OPENED) against a test session. |
get_expected_narrative | The canonical happy-path recorded in the editor — ground truth for verify_deployment. |
verify_deployment | Run the full happy-path end-to-end and return a per-assertion pass/fail diff. |
get_runtime_docs | Inline README for the React + runtime npm packages (usage snippets, option surface, troubleshooting). |
get_backend_example | Starter Next.js / Express / FastAPI backend snippet. |
get_embedding_guide | Per-avatar implementation recipe — states, expressions, outbound events, copy-paste <AsmiAvatar> mount. |