Basic Setup

The fastest way in — no install. Point your agent at the Masky API skill — a single markdown file that teaches any capable AI (Claude, or anything with a shell or HTTP tool) to call the Masky API directly with curl. Paste that URL into your prompt, or drop the file in your project, then ask it to make avatars, conversations, and images, or to add “Login with Masky” to your site. Full endpoint reference is in that file and at /api/docs.

Set up Masky in Claude (MCP)

One-time setup, about 30 seconds. The Masky MCP server exposes your avatars, image generation, conversations, turn rendering, and SSO app registration as tools Claude can call directly — in Claude Code, Claude Desktop, or the Anthropic API.

1. Generate a key. Sign in up top, then click Generate key below and copy the mky_… token — it's shown only once.

2. Add Masky with one command. In your terminal, drop your token into:

claude mcp add masky -e MASKY_API_KEY=mky_YOURKEY -- npx -y masky-mcp-server

That's the whole install — no file editing. The next time you start Claude Code, the Masky tools are loaded.

On Claude Desktop there's no CLI: open Settings → Developer → Edit Config, add this entry inside mcpServers, then quit and reopen the app:

"masky": {
  "command": "npx",
  "args": ["-y", "masky-mcp-server"],
  "env": { "MASKY_API_KEY": "mky_YOURKEY" }
}

3. Prompt it. "Use Masky to make a two-avatar podcast where a startup founder pitches a skeptical engineer — give me the embeddable live URL."

Masky API keys

Long-lived bearer tokens for the public Masky HTTP API and the Masky MCP server. Keep keys secret — anyone with one acts as you.

Use it directly (HTTP API)

Prefer raw HTTP? Authenticate with Authorization: Bearer mky_.... Endpoints documented at /api/docs.

curl -X POST https://masky.ai/api/conversations \
  -H "Authorization: Bearer $MASKY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"avatarOwnerUserId":"twitch:12345","avatarId":"abc"}'