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
  • API keys and workspaces/docs/authentication
  • 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, scenes and stickers/docs/generate/design-assets
  • Cursor follower/docs/generate/cursor-follower
  • Batch generation/docs/generate/batch
  • 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
  • Smooth mascot playback/docs/integrations/playback
  • Hosting and file formats/docs/generate/cdn
  • File sizes/docs/generate/file-sizes
  • Image and video exports/docs/manage/media-exports
  • Terminal quickstart/docs/terminal
  • Command line reference/docs/terminal/commands
  • CLI browser login/docs/authentication/cli
  • Float a mascot on your Mac/docs/integrations/desktop
  • TypeScript SDK/docs/sdk/typescript
  • 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
  • Changelog/docs/reference/changelog
  • Migrate to mascots and canvases/docs/manage/studio-migration
Get an API key
Documentation

Masko in Lovable

Lovable can create a mascot for your app through Masko's MCP server. The connection creates the mascot and its animations, and the finished files end up in your project. Your published app plays those files. The connection works while you build, and your published app never calls Masko.

Connect Masko

Lovable connects to Masko with an API key. Masko's sign-in works only in Claude, ChatGPT and Cursor for now, so use the key option below.

  1. On masko.ai, open Developers → API keys, choose Create API key, name it Lovable and keep Read + Write. Copy the key: it is shown once.
  2. In Lovable, open Connectors, click + at the top right, then MCP server.
  3. Name it Masko and enter the server URL https://masko.ai/api/mcp.
  4. For authentication, choose Bearer token or API key and paste your Masko key. Click Add server.

The key belongs to the workspace you were in when you created it, personal or team, and generation spends that workspace's credits. Only a team owner or admin can create a team key. If MCP server is greyed out in Lovable, an admin of your Lovable workspace has turned off custom MCP servers.

Other apps connect the same way: see MCP server.

Try it

  • "Show my Masko credit balance. Don't generate anything."
  • "Add a friendly mascot to my habit tracker. It waits while I'm working and celebrates when I finish a habit."
  • "Make the mascot idle, then celebrate, then return to idle."

What Lovable can do

  • Create a mascot, its poses and its animations.
  • Check a job until its files are ready.
  • Export and publish assets, and get their CDN links.
  • Read your credit balance and open a credit checkout link.

Costs

Generation uses credits from the Masko workspace your key belongs to. Ask for the estimated cost before generating. The estimate tools return it before anything is spent.

Publishing the files

New mascots made through the MCP server start with public CDN hosting off. To use the files in a public app, publish the mascot's assets and use the CDN links. Private links expire, so a production app that needs private files must fetch fresh links from its backend.

Playback

Use the playback guide to play the animation in your app. A single loop needs one video element. Changing between clips needs two elements. No Masko package is needed.

Limits

  • The connection works while you build. Visitors to your published app cannot reach Masko through it.
  • Generation spends credits from the key's workspace.
  • The connection allows 120 requests per minute per key.

Security

  • Lovable keeps the key you paste and sends it with each request to Masko. Create a key just for Lovable, so you can revoke it on its own.
  • The key lives in the Lovable connection, never in your app's code. Your published app only plays files and needs no Masko key.
  • To remove access, delete the server in Lovable and revoke its key in Developers → API keys.