Masko MCP server

The Masko MCP server gives your AI app tools to create a mascot, animate it, build an interactive canvas and bring the files into your project. You ask in plain words, and the app calls the tools. One server works for every app:

https://masko.ai/api/mcp

Connect your app

Your app connects in one of two ways:

Sign in, in Cursor, Claude and ChatGPT. Your app opens masko.ai. You sign in, choose your personal or team workspace and approve. You never paste a key. A team connection needs an owner or admin.
API key, in Claude Code, Codex, VS Code and other apps. Open Developers → API keys, choose Create API key and keep Read + Write. Copy the key: it is shown once. It belongs to the workspace you are in when you create it. Then set it in your terminal:

export MASKO_API_KEY=masko_YOUR_KEY

Add that line to your shell profile, such as ~/.zshrc, so every new terminal has it. Never commit the key or put it in browser code.

Pick your app for its setup. The MCP tab of the Developers page shows the same steps with copy buttons.

Your app

Uses your API key. Run this in the terminal where MASKO_API_KEY is set:

claude mcp add --transport http --scope user masko https://masko.ai/api/mcp \
  --header "Authorization: Bearer $MASKO_API_KEY"

--scope user adds Masko to all your projects. Leave it out to add Masko to this project only. Start Claude Code and run /mcp: masko shows as connected. From the terminal, claude mcp list checks it.

The command saves the key in your Claude Code settings on this computer. To share the setup with your team in a repository, put this in .mcp.json instead. Each person keeps their own MASKO_API_KEY:

{
  "mcpServers": {
    "masko": {
      "type": "http",
      "url": "https://masko.ai/api/mcp",
      "headers": { "Authorization": "Bearer ${MASKO_API_KEY}" }
    }
  }
}

Check the connection

Ask your agent:

Show my Masko projects, mascots and credit balance. Don't generate anything.

Reading is free. If something is off:

What you see	What to do
The app shows no Masko tools	Run `/mcp` (Claude Code, Codex) or open the app's MCP settings, check that masko is connected, then restart the app.
A browser sign-in opens and fails in Claude Code or Codex	The key is missing, revoked, or not a Read or Read + Write API key. Check `echo $MASKO_API_KEY` in the terminal that starts the app, then add Masko again.
"This connection is read-only"	Use a Read + Write key, or reconnect and approve write access.
Other projects or credits than you expected	The key or connection belongs to another workspace. Create the key in the right workspace, or reconnect and choose it.

Then ask in plain words

Create a friendly mascot for this app with Masko and make it wave hello.
Tell me the cost first.

When someone finishes a lesson, make the mascot celebrate,
then go back to its idle loop.

Add these animations to this React app, with no flicker between clips.

The agent shows you the cost before anything paid, follows each job until the files are ready and writes the player code. More prompts are in Build with your AI agent.

What the tools do

Area	Tools
Account and credits	`get_credits`, `create_credit_checkout`, `get_credit_checkout`
Projects and mascots	`list_projects`, `create_project`, `list_mascots`, `get_mascot`, `create_mascot`, `import_mascot_image`, `upload_mascot_image`
Images and animations	`generate_mascot_image`, `animate_mascot`
Jobs and files	`get_job`, `list_jobs`, `get_asset`, `list_assets`, `export_asset`, `publish_mascot_assets`, `get_mascot_cdn`
Interactive canvases	`list_canvases`, `create_canvas`, `get_canvas`, `save_canvas`, `validate_canvas`, `estimate_canvas_generation`, `generate_canvas`, `get_canvas_status`, `repair_canvas_media`, `list_canvas_history`, `release_canvas`, `get_release_delivery`
Guides	`get_integration_guide`

Voices and talking animations are not MCP tools yet. An agent that has MASKO_API_KEY makes them through the REST API.

Good to know

Credits. Generation spends the connected workspace's Masko credits, not your AI app's subscription. Reading, estimates and job checks are free. See credits and costs.
Your own image. The server runs on masko.ai and cannot read files on your computer. Give it an HTTPS image URL, upload the image on masko.ai first, or let an agent that has MASKO_API_KEY upload it with POST /v1/upload.
Hosting. New mascots made through the MCP server start with public hosting off, and their file links expire. Ask the agent to publish the assets before you use their links in a public app.
A stopped run. Ask the agent to check its existing jobs before it generates again, so you never pay twice.
Limits. 120 requests per minute per connection.

Pages you will use

Page	What you do there
Developers → MCP	Copy the setup for your app
Developers → API keys	Create or revoke the key for Claude Code, Codex, VS Code and other apps
Connected apps	See and disconnect the apps you signed in with
Billing	Buy credits

Disconnecting an app or revoking a key stops its future requests. It does not delete your mascots or cancel a generation that already started.

Without MCP

Any coding agent that runs commands can use the REST API with MASKO_API_KEY and the docs at masko.ai/llms.txt: see Build with your AI agent. To work from the terminal yourself, see the terminal quickstart.

Masko MCP server

Connect your app#

Check the connection#

Then ask in plain words#

What the tools do#

Good to know#

Pages you will use#

Without MCP#