mascotlab-mcp

MascotLab gives an app one character and keeps it that way.

CommunityOnlineNo sign-inGlobalFreeCan modify data

What it can do

  • Get Account: Credit balance, subscription state, and what each generation costs (mascot 2, prop 2, pose 2, animation 5 credits). Call this before expensive work to know what the balance allows.
  • List Projects: The user's MascotLab projects with ids, and which one is active. Generations always land on the active project.
  • Select Project: Makes a project the active one. All create_* tools generate into the active project, so switch first when working across projects.

What data it sees

Do you need an account

No: the server works without sign-in

MascotLab gives an app one character and keeps it that way.

Describe a mascot once and it is locked. Every pose, prop and animation you generate afterwards is rendered against that locked reference rather than from the description again, so the character on your empty state and the character on your error page are recognisably the same one. That is the difference from a general image tool, which redraws a new character every call.

Ask in plain language and the agent picks the tools. It gets back a download URL and writes the PNGs and MP4s straight into your repository, so the artwork arrives without leaving your editor.

Generations are asynchronous: every create tool returns a generation id immediately and check_generation polls it to completion. Images take roughly 10 to 40 seconds, animations one to three minutes.

Tools: get_account, list_projects, select_project, create_project, get_board, create_mascot, create_prop, create_pose, create_animation, check_generation, download_artifact.

Hosted remote server, so there is nothing to install and no API key to paste: the first request answers with a sign-in challenge and you approve it in a browser. Artwork you generate is yours, including commercially.

Docs: https://mascotlab.io/mascot-generator-for-claude-code

How to connect

How to connect mascotlab-mcp to Claude

The server address to paste into Claude settings:

https://mascotlab-mcp--joel-mwaka.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect mascotlab-mcp to ChatGPT

The server address to paste into ChatGPT settings:

https://mascotlab-mcp--joel-mwaka.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect mascotlab-mcp to Cursor

The server address to paste into Cursor settings:

https://mascotlab-mcp--joel-mwaka.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (11)

Raw names from tools/list. Only developers need these.

get_accountCredit balance, subscription state, and what each generation costs (mascot 2, prop 2, pose 2, animation 5 credits). Call this before expensive work to know what the balance allows.
list_projectsThe user's MascotLab projects with ids, and which one is active. Generations always land on the active project.
select_projectMakes a project the active one. All create_* tools generate into the active project, so switch first when working across projects.
create_projectCreates a new project and makes it the active one, so following create_* calls land in it.
get_boardEverything in a project: mascots, props, poses, animations and in-flight generations, with the ids other tools take. Defaults to the active project.
create_mascotGenerates a new mascot character from a description (2 credits, charged only on success). Returns a generation_id immediately; poll it with check_generation (about 10-40 seconds). The mascot anchors every later pose and animation, so describe species, personality and look in one sentence.
create_propGenerates a standalone object the mascot can hold or use, e.g. a wrench or a coffee cup (2 credits, charged only on success). Returns a generation_id for check_generation. Props are reusable across poses.
create_poseRenders a mascot performing an action, optionally holding props, and optionally with a second mascot in the same frame (2 credits, charged only on success). Identity is anchored to each mascot's reference sheet so the characters stay on-model. Returns a generation_id for check_generation.
create_animationAnimates a pose, or the mascot itself, into a short silent MP4 clip (5 credits; requires an active subscription). The clip can be pinned at both ends with end_pose_id, or looped so it ends where it began. Returns a generation_id; animations take one to three minutes, so call check_generation with wait_seconds 50 and repeat until it settles.
check_generationStatus of a generation_id from any create_* tool. With wait_seconds (recommended: 45) it waits server-side and returns as soon as the render settles, so one or two calls usually cover an image and a few cover an animation. Completed results include a short-lived download URL.
download_artifactMints a fresh download URL (valid 10 minutes) for any artifact on the board: mascot, prop, pose (PNG) or animation (MP4). Use the ids from get_board, and fetch the URL promptly, for example with curl, to save the file into the repository.