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
  • 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 in n8n

n8n reaches Masko through its MCP server. An AI Agent can use Masko's tools on its own, for example to create a mascot and animate it from a chat. A workflow can also call one Masko tool as a fixed step, such as reading your credits or checking a job.

Create the credential

On n8n Cloud, n8n signs in to Masko, so nobody copies a key. The credential is created once and every Masko node reuses it.

  1. In any Masko node below, set Authentication to MCP OAuth2, open the credential list and choose Create new credential.
  2. Set Server URL to https://masko.ai/api/mcp and keep Use Dynamic Client Registration on. Name the credential Masko and click Save.
  3. Click Connect. In the window that opens, choose the workspace whose credits n8n will use and click Connect Masko.

Generation spends the credits of the workspace you chose. Only a team owner or admin can connect a team workspace.

Self-hosted n8n

Self-hosted n8n connects with an API key instead:

  1. On masko.ai, open Developers → API keys, choose Create API key, name it n8n and keep Read + Write. Copy the key: it is shown once.
  2. In any Masko node below, set Authentication to Bearer Auth, open the credential list and choose Create new credential.
  3. Paste the key into Bearer Token, without the word Bearer: n8n adds it. Name the credential Masko and click Save.

The key belongs to the workspace you were in when you created it, personal or team. Only a team owner or admin can create a team key.

Give an AI Agent Masko's tools

  1. In the AI Agent node, click + under Tool and choose MCP Client Tool.
  2. Set Endpoint to https://masko.ai/api/mcp and keep Server Transport on HTTP Streamable.
  3. Set Authentication to MCP OAuth2, or Bearer Auth on self-hosted n8n, and pick the Masko credential.
  4. Set Tools to Include to Selected and pick the tools the agent needs. A short list keeps the agent on task and leaves out paid tools you did not plan for.

Try it in the chat:

  • "Show my Masko credit balance. Don't generate anything."
  • "Create a fox mascot for my newsletter and tell me the cost before animating it."

Call one tool as a step

Use the MCP Client node when the workflow should always do the same thing.

  1. Add an MCP Client node after your trigger.
  2. Keep Server Transport on HTTP Streamable and set MCP Endpoint URL to https://masko.ai/api/mcp.
  3. Set Authentication to MCP OAuth2, or Bearer Auth on self-hosted n8n, and pick the Masko credential.
  4. Choose the Tool, for example get_credits, and fill its inputs.
  5. Click Execute step.

The node returns the tool's result in content[0].text. For get_credits, that holds data.total with your balance.

Wait for a generation

Generation tools answer at once with a job, and the files arrive later. Continue the workflow in one of two ways:

  • Check the job. Add a Wait node, then an MCP Client node with get_job and the job's ID. Loop until the status is completed or failed. A wait of 30 seconds or more between checks is plenty.
  • Get called back. Add a Webhook trigger in a second workflow and register its production URL as a Masko webhook for job.completed and job.failed. Masko posts the job with its file links when it finishes. Check the signature before trusting the payload.

What the tools do

  • Create a mascot, its poses and its animations.
  • Make talking animations and backgrounds.
  • Build a canvas, the mascot's states and the moments that switch between them.
  • 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 you connected. The estimate tools return the cost before anything is spent: put one before any paid tool in a workflow that runs on its own. Reading, listing and checking jobs are free.

Limits

  • The connection allows 120 requests per minute. Space out loops that check jobs.
  • New mascots made through the MCP server start with public CDN hosting off. Publish the mascot's assets before sending CDN links anywhere public.

Security

  • n8n keeps its Masko sign-in, or your key, in the credential and sends it with each request to Masko. With a key, create one just for n8n, so you can revoke it on its own.
  • To remove access, delete the credential in n8n, then disconnect n8n in Connected apps or revoke its key in Developers → API keys.