AI Agent Integration
AI coding agents can create mascots and generate assets through Masko's public REST API. This works in any agent that can make HTTP requests or run a script.
Choose Your Integration
| Method | Best For | Setup |
|---|---|---|
| Terminal | Let an agent control a desktop mascot with local commands | Install the macOS runtime |
| AI Skill | Give an agent Masko-specific workflows and API guidance | Instructions |
| ChatGPT plugin (preview) | Connect a Masko account for mascot generation and interactive canvases | OAuth connection on an enabled deployment |
| Direct API | Scripts, applications, and custom agent tools | Quickstart |
| OpenAPI | Generate a typed client or inspect the complete contract | OpenAPI spec |
Quick Setup
Create an API key in Developer Settings, then pass it as a bearer token:
curl https://api.masko.ai/v1/credits \
-H "Authorization: Bearer $MASKO_API_KEY"What Agents Can Do
- Create and manage mascots
- Generate images, animations, edits, logos, and scenes
- Poll generation jobs and retrieve CDN URLs
- Build and update interactive canvases
- Manage projects, assets, and references
Agent Resources
| Resource | URL |
|---|---|
| Product and documentation index | masko.ai/llms.txt |
| Complete guides and API operation index | masko.ai/llms-full.txt |
| Documentation search | GET https://api.masko.ai/v1/docs?q=animation |
| OpenAPI specification | api.masko.ai/v1/openapi.json |
Control is separate from generation
An agent can call masko state working --name ko or masko play celebrate --name ko --wait to control a running character. These commands play authored media; they do not invent new animations. Use terminal authoring or REST generation to add a new reaction, review its cost, and release the result.
Looking for the MCP integration?
The former Masko MCP setup guide has been retired. The new ChatGPT plugin uses a separate OAuth connection and is in developer preview. The Masko skill and REST API remain available for other agent integrations. To control a mascot on your Mac, follow the terminal guide.