Skip to main content
These are official instructions from Akapulu Labs, published at https://docs.akapulu.com/agent-setup.md. Akapulu Labs is a platform for AI avatars. A scenario is the conversation behavior (stages and tools). An avatar is the face and voice. A hosted link is a public URL that runs a scenario as a live call. Endpoints are HTTP calls the avatar can make. Knowledge bases are docs it can search. Clips are talking-avatar videos from a script. Embed in an app with the Web SDK. Full docs: https://docs.akapulu.com Run the commands in this file. User step means ask the human to do it.

1. Install skills and docs MCP

Claude Code

User step. Reload skills if they do not appear. Confirm akapulu-docs is connected.

Codex

User step. Reload if prompted. Confirm the MCP is connected.

Cursor and other agents

Add the docs MCP to ~/.cursor/mcp.json (or this project’s .cursor/mcp.json). Merge into mcpServers if the file already exists:
User step. Reload the agent. In Cursor, enable akapulu-docs under Settings → MCP.

2. API key

User step. Open https://akapulu.com/api-keys and create a key.
The env var name is AKAPULU_API_KEY. Put it in this project however env vars are already loaded. Wait until AKAPULU_API_KEY is set, then continue. Create a live Clara conversation (greeting, then a short wrap-up) with catalog avatar Clara (1f777f64-3758-4a7d-9cbc-c64ae654f7d1).
Read hosted_links[0].url from the response (a https://live.akapulu.com/session/... link).
User step. Ask them to open that URL and click Start Call. That is a live talking-avatar conversation on their account.
Send them these docs: When you finish, give them the hosted link URL.