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 '*' --yesAdd --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:
| Skill | Example 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.
