MascotVibe in Your IDE

Generate and animate mascots directly from Claude Desktop, Cursor, VS Code, or any AI tool that supports the Model Context Protocol. No browser required.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and services. Instead of copy-pasting between your browser and your AI tool, MCP lets the AI call APIs directly on your behalf.

With the MascotVibe MCP server, you can ask Claude, Cursor, or Copilot to generate mascots, animate them, check your credit balance, and more. The AI handles the API calls while you stay focused on your work.

Installation

No installation needed if you use npx. Just add the configuration to your AI tool and you're ready to go.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mascotvibe": {
      "command": "npx",
      "args": ["-y", "@mascotvibe/mcp-server"],
      "env": {
        "MASCOTVIBE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

VS Code / Copilot

Add to .vscode/settings.json:

{
  "mcp": {
    "servers": {
      "mascotvibe": {
        "command": "npx",
        "args": ["-y", "@mascotvibe/mcp-server"],
        "env": {
          "MASCOTVIBE_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

Available Tools

`generate_mascot`

Generate AI mascot characters from a text description or website URL. Returns 4 unique variations in your chosen art style.

Parameters

description (string): Describe your brand or desired mascot
websiteUrl (string): Website URL for brand context
style (enum): kawaii, cartoon, 3d-render, flat, pixel, hand-drawn (default: cartoon)

`animate_mascot`

Animate a mascot with various animation styles. Creates WebM, APNG, and MP4 outputs.

Parameters

mascotId (string, required): The mascot ID to animate
animationType (enum, required): wave, celebrate, idle, think, sad, dance, sleep, angry, nod, jump, spin, peek, custom
duration (number): 5 or 10 seconds (default: 5)
size (number): 128, 256, 512, or 720 pixels (default: 512)
customPrompt (string): Custom animation description (required for "custom" type)

`check_animation`

Check the status of an animation job and get download URLs when complete.

Parameters

animationId (string, required): The animation job ID

`list_mascots`

List your MascotVibe mascots with IDs, names, and images.

Parameters

limit (number): Max mascots to return, 1-100 (default: 20)

`check_credits`

Check your MascotVibe credit balance.

No parameters required

Example Conversations

Generating a mascot

You: Create a mascot for my coffee shop called "Bean There" in kawaii style
AI: I'll generate mascots for your coffee shop! Let me create 4 kawaii-style variations based on the "Bean There" brand...
AI: Here are your 4 mascots! 1. Brewster (a cheerful coffee bean), 2. Latte (a cozy bear barista), 3. Mocha (a playful cat with a coffee cup), 4. Espresso (a zippy robot brewing coffee). Which one do you like best?

Animating a mascot

You: Animate Brewster with a wave animation at 720px
AI: Starting a wave animation for Brewster at 720px. I'll check back when it's ready...
AI: Your animation is done! Here are the download links: WebM (Chrome/Android), APNG (iOS/Safari), MP4 (universal). The wave animation turned out great with Brewster's little coffee bean arms.

Quick credit check

You: How many MascotVibe credits do I have left?
AI: You have 42 credits remaining. That's enough for about 8 mascot generations or 2 five-second animations.

Get Your API Key

Get API Key REST API Docs