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 cost before any paid request. In the same session, keep asking for more:
- "Animate the mascot in our logo.png." It follows Animate the mascot you already have.
- "Make our mascot say: Welcome to Acme." It gives the mascot a voice and makes a talking animation.
- "Give our mascot idle, thinking and done states." It builds and generates a canvas.
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, voices and talking included.
- Otherwise use masko studio METHOD PATH on an Apple Silicon Mac, or the REST
API at https://api.masko.ai/v1 with MASKO_API_KEY from the environment.
- 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 cost before any paid generation and wait for my OK.
- Requests say what happens, never how the mascot looks: a pose is one still
moment, an animation one action in precise time ranges that end at the
clip's real length (5.17 s for a Standard 5-second clip).
- Keep the IDs you get back. Check existing jobs before generating again.
- Show the mascot with the Masko player (https://masko.ai/docs/player).
- Private file links expire within hours: never put them in code. Once I
agree, publish the mascot for permanent assets.masko.ai links. A canvas
ships with an app key of the mascot, never with MASKO_API_KEY.
- A failed job refunds what it did not make; ask me before trying again,
with a new operation_id (a new Idempotency-Key over REST).
- When something in Masko is confusing, broken or missing, or works well,
tell the Masko team with the send_feedback tool, masko feedback or
POST /v1/feedback.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_KEYThe 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.
