Skip to content
maskostudioDocs

All pages

  • Overview/docs/use-cases
  • Mobile app/docs/use-cases#mobile
  • Website/docs/use-cases#website
  • Desktop/docs/use-cases#desktop
  • AI agents/docs/use-cases#agents
  • Videos/docs/use-cases#videos
  • Brand/docs/use-cases#brand
  • Start building/docs/ai-agents
  • Set up once/docs/ai-agents#set-up-once
  • Ask in plain words/docs/ai-agents#ask-in-plain-words
  • What your agent does/docs/ai-agents#what-your-agent-does
  • MCP server/docs/mcp
  • Masko for Cursor/docs/ai-tools/cursor
  • Masko in ChatGPT/docs/ai-tools/chatgpt
  • Start here/docs/tutorials#start-here
  • All tutorials/docs/tutorials
  • Create your first mascot/docs/tutorials/first-mascot
  • Create an animated character/docs/tutorials/first-animation
  • Make a character talk/docs/tutorials/make-it-talk
  • Put your mascot on your website/docs/tutorials/mascot-on-your-website
  • Guide onboarding with a talking mascot/docs/tutorials/web-onboarding-mascot
  • Add a mascot that celebrates progress and welcomes users back/docs/tutorials/web-progress-companion
  • Add a talking support mascot in the bottom right/docs/tutorials/web-support-mascot
  • Show a mascot while your AI thinks/docs/tutorials/ai-loading-mascot
  • Give your AI agent a face/docs/tutorials/ai-agent-face
  • Animate the mascot you already have/docs/tutorials/animate-your-mascot
  • How to make Telegram stickers/docs/tutorials/telegram-stickers
  • How to make Discord stickers/docs/tutorials/discord-stickers
  • Quickstart: your first animation/docs/quickstart
  • Terminal quickstart/docs/terminal
  • API keys and workspaces/docs/authentication
  • CLI browser login/docs/authentication/cli
  • How mascots work/docs/how-mascots-work
  • Credits and costs/docs/credits
  • From text/docs/create/from-text
  • From an image/docs/create/from-image
  • From a website/docs/create/from-website
  • From a brand book/docs/create/from-brand-book
  • Reference images/docs/manage/references
  • What you can generate/docs/generation
  • Pose-to-animation walkthrough/docs/generate/workflow
  • Images and poses/docs/generate/images
  • Animations/docs/generate/animations
  • Talking animations/docs/generate/talking
  • Logos, backgrounds and stickers/docs/generate/design-assets
  • Cursor follower/docs/generate/cursor-follower
  • Batch generation/docs/generate/batch
  • Image and video exports/docs/manage/media-exports
  • Canvases and releases/docs/canvas
  • Build a canvas/docs/canvas/build
  • Canvas templates/docs/canvas/templates
  • Generate canvas assets/docs/canvas/generate-all
  • Export a canvas/docs/canvas/export
  • Overview and demo/docs/player
  • Play one animation/docs/player/one-animation
  • Play a canvas/docs/player/canvas
  • Hosting and file formats/docs/generate/cdn
  • File sizes/docs/generate/file-sizes
  • Float a mascot on your Mac/docs/integrations/desktop
  • Jobs and polling/docs/manage/jobs
  • Webhooks/docs/manage/webhooks
  • Manage mascots and assets/docs/manage/collections
  • All endpoints/docs/reference
  • Requests and responses/docs/reference/conventions
  • Errors and recovery/docs/reference/errors
  • Command line reference/docs/terminal/commands
  • TypeScript SDK/docs/sdk/typescript
  • Changelog/docs/reference/changelog
  • Migrate to mascots and canvases/docs/manage/studio-migration
Get an API key
Documentation

Masko skill for coding agents

Any coding agent that can run commands and read web pages can use the Masko REST API. It needs an API key and a prompt that names masko.ai.

Set your API key

Create a key with Read + Write access in API keys and copy it: it is shown once. Set it in the terminal where you start your agent, then check it with a free balance request:

export MASKO_API_KEY=masko_YOUR_KEY

curl https://api.masko.ai/v1/credits \
  -H "Authorization: Bearer $MASKO_API_KEY"

Keep the key on your machine or your server. Never put it in browser code or commit it.

Ask in plain words

Name masko.ai in your prompt so the agent knows where to look. It reads masko.ai/llms.txt, follows the workflows and the OpenAPI specification, and makes the calls with MASKO_API_KEY:

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

"Tell me the cost first" makes it show you the credits before any paid request. In the same session, keep asking for more:

Use Masko in every session

If you use Masko often, add these lines to your project's agent instructions, such as CLAUDE.md or AGENTS.md, so you don't have to name masko.ai each time. Keep what is already there:

## Masko

Masko (masko.ai) makes our mascot images and animations.
- Use the Masko MCP tools when they are connected.
- Otherwise use the REST API at https://api.masko.ai/v1 with MASKO_API_KEY
  from the environment. Voices and talking always use the REST API.
- Docs: https://masko.ai/llms.txt lists every guide, and
  https://api.masko.ai/v1/openapi.json has the exact requests.
- Never print or commit MASKO_API_KEY, and never put it in browser code.
- Tell me the credits before any paid generation and wait for my OK.
- Keep the IDs you get back. Check existing jobs before generating again.

Add the MCP server

With the same key, your agent can also use Masko's tools through the MCP server. In Claude Code:

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

In Codex:

codex mcp add masko --url https://masko.ai/api/mcp \
  --bearer-token-env-var MASKO_API_KEY

The MCP server page has the setup for Cursor, Claude, ChatGPT, VS Code and other apps. For four ready-made workflow skills in Cursor, see Masko for Cursor.