🔌MCP Integration

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:

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:

.cursor/mcp.json

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

VS Code / Copilot

Add to .vscode/settings.json:

.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

I'll generate mascots for your coffee shop! Let me create 4 kawaii-style variations based on the "Bean There" brand...

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

Starting a wave animation for Brewster at 720px. I'll check back when it's ready...

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?

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