thumbnail-creator

Thumbnail Creator

Generate professional YouTube thumbnails using AI. This skill connects to the Thumbnail Creator API to create thumbnails, analyze videos, manage creative assets, and generate SEO content.

Setup

Before using this skill, ensure you have:

1. A Thumbnail Creator account at https://app.thumbcraft.io
2. An API key from Settings → Developers → API Keys

MCP Configuration (Recommended)

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "thumbnail-creator": {
      "url": "https://app.thumbcraft.io/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

REST API

Base URL: https://app.thumbcraft.io/api/v1

All requests require the header:

Authorization: Bearer YOUR_API_KEY

Available Tools

Thumbnail Generation

generate_thumbnail

Create a thumbnail from a text description.

Parameters:

• prompt (required): Detailed description of the thumbnail
• youtube_url (optional): YouTube URL for context
• style_id (optional): Apply a saved style
• face_ids (optional): Array of face IDs to include
• brand_id (optional): Brand ID for colors/logo
• aspect_ratio (optional): "16:9" (default) or "9:16"

Best practices for prompts:

• Be specific about composition, colors, and emotions
• Mention text overlays explicitly if needed
• Describe the main subject's expression and pose
• Include background details

Example:

Generate a thumbnail with a surprised man looking at a giant golden trophy.
Bold yellow text says "I WON". Dark gradient background with sparkles.
Photorealistic style, dramatic lighting.

analyze_video

Analyze a YouTube video and get 5 thumbnail concepts with prompts.

Parameters:

• youtube_url (required): Full YouTube URL

Returns: Video summary and 5 thumbnail concepts with:

• Title and description
• Ready-to-use generation prompt
• Emotional hook explanation