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
  • Masko in Lovable/docs/ai-tools/lovable
  • Masko in Devin/docs/ai-tools/devin
  • Masko in n8n/docs/ai-tools/n8n
  • Masko in Hermes Agent/docs/ai-tools/hermes
  • Masko in OpenClaw/docs/ai-tools/openclaw
  • 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
  • Props/docs/manage/props
  • 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
  • Sounds/docs/generate/sounds
  • Animation presets/docs/generate/presets
  • Write good requests/docs/generate/requests
  • 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
  • Ship in an app with an app key/docs/player/app-keys
  • Play on an ESP32 board/docs/player/esp32
  • 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 for Cursor

Create a mascot, animate your own artwork and add the finished assets to your codebase from Cursor.

Connect your account

The plugin has four workflow skills and a connection to Masko's hosted MCP server. Install the skills in your project:

npx skills add masko-ai/masko-plugins --agent cursor --skill '*' --yes

Add --global for all your Cursor projects, or replace '*' with create-mascot, animate-mascot, build-interactive-mascot or integrate-mascot. Skills alone do not connect your account: enable Masko in Cursor's Customize page, connect the MCP server, sign in on masko.ai, choose a personal or team workspace and approve. No API key is needed.

To configure only the MCP connection, add this server to Cursor's MCP settings:

{
  "mcpServers": {
    "masko": {
      "url": "https://masko.ai/api/mcp",
      "auth": {
        "CLIENT_ID": "https://masko.ai/oauth/clients/cursor",
        "scopes": ["masko:read", "masko:write"]
      }
    }
  }
}

The client ID is public configuration (a JSON client metadata document), not a credential. It is registered for Cursor only; other apps connect as shown in MCP server. Team connections require an owner or admin, and you can disconnect in Settings → Connected apps.

Start with your existing work

Try: “Show my Masko projects, mascots and credit balance. Don't generate anything.” Then choose a workflow:

SkillExample prompt
Create a mascot“Create a friendly fox for my fitness app. Show me the cost first.”
Animate a mascot“Animate my existing mascot waving hello.”
Build interactions“Make it celebrate a completed lesson, then return to idle.”
Integrate assets“Add these animations to this React project without flickering between clips.”

Generation spends the connected workspace's Masko credits, which Cursor's subscription does not include, so review the cost first. To buy more, the agent points you to Billing: no tool takes a payment. Team purchases require the team owner.

Use your own character

Reuse a saved Masko image or give an HTTPS image URL (PNG, JPEG, WebP or GIF up to 10 MB). The hosted server cannot read files on your computer or fetch private network addresses. For a local image, Cursor uploads it with the masko command (masko studio POST upload --file logo.png), or you upload it on masko.ai first and ask Cursor to find it. Masko tells it never to put your files on another public host.

Put the result into your product

The agent follows each job until the assets are ready. For a canvas release, the integration skill installs the Masko player for your platform and connects your app's events to it with set and fire; a single looping clip plays in the same player from its hosted files (play one animation).

New mascots are private and preview links stop working within hours, so a website or app plays single animations from the permanent public links that publishing gives, and a canvas with an app key. The plugin does not deploy your app or put a mascot on your Mac.

Support

If tools are missing, check that the Masko MCP server is enabled and authorized, and reconnect through OAuth instead of pasting credentials into chat. If an operation fails, ask the agent to send Masko feedback, or email paul@masko.ai with the request or job ID.

Privacy policy · Terms of service