Masko MCP Server

The Masko MCP server gives your AI coding agent native tools to create mascots, generate images, animate characters, and build interactive canvases.

Server URL: https://masko.ai/api/mcp

Install

Configure your client to connect with Masko.

Client

Add the MCP server to your project config using the command line:

claude mcp add --scope project --transport http masko "https://masko.ai/api/mcp"

Alternatively, add this configuration to .mcp.json:

{
  "mcpServers": {
    "masko": {
      "type": "http",
      "url": "https://masko.ai/api/mcp"
    }
  }
}

After configuring the MCP server, you need to authenticate. In a regular terminal (not the IDE extension) run:

claude /mcp

Select the masko server, then Authenticate to begin the authentication flow.

Authentication

Most clients will automatically prompt you to log in during setup. This opens a browser window where you can log in to your Masko account and confirm access.

For clients that don't auto-prompt, get your API key from the Developer dashboard and add it as a header in your config.

After authentication, verify the connection by asking your agent: "Check my Masko credit balance" - it should call the get_credits tool.

Available Tools

Once connected, your agent has 16 tools:

Mascots

Tool	Description
`create_mascot`	Create a new mascot from a text description and art style
`list_mascots`	List your mascots to find IDs
`get_mascot`	Get all poses, assets, and CDN URLs for a mascot

Generation

Tool	Description
`generate`	Generate an image, animation, edit, or logo. Returns CDN URLs instantly
`generate_batch`	Generate up to 10 items at once
`get_job`	Check generation status. Supports `wait=true` for long-polling
`list_jobs`	List recent generation jobs

Canvas

Tool	Description
`create_canvas`	Create an interactive state machine
`create_canvas_from_template`	One-step canvas from a pre-built template
`generate_all_canvas`	Generate all images and animations for a canvas
`list_canvas_templates`	List available templates

Utilities

Tool	Description
`get_credits`	Check credit balance before generating
`list_styles`	List all 38 art styles
`search_docs`	Search Masko docs by keyword
`create_project`	Create a project to group mascots
`list_projects`	List your projects

Key Concepts

CDN URLs are instant. Every generate call returns CDN URLs before generation finishes. They serve a placeholder that swaps to the real file automatically. Embed them in code right away.

Animation from scratch. You don't need to generate an image first. The agent passes both an image_prompt (the pose) and animation_prompt (the motion) to create everything in one step.

Auto-resolved sources. When animating an existing item, the agent just passes item_id. The server finds the correct source image automatically.

Credits. Image = 1, animation = 5/sec, edit = 1, logo = 5. Animations loop by default. Background removal and size variants are free.

Troubleshooting

Issue	Solution
Tools not showing up	Restart your editor after adding the MCP server
Authentication failed	Re-run the auth step for your client (see Install above)
Token expired	Tokens last 30 days. Re-authenticate to get a new one
Insufficient credits	Call `get_credits` to check. Top up at masko.ai
Windsurf not connecting	Ensure `mcp-remote` is installed (`npx -y mcp-remote`)
Codex not connecting	Add `rmcp_client = true` to `[features]` in config.toml