Generate AI-powered YouTube thumbnails, analyze videos for thumbnail ideas, manage styles/faces/brands, and create SEO-optimized titles and descriptions. Use when users want to create thumbnails, need thumbnail ideas for a video, want to clone a thumbnail style, or need YouTube SEO content.
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.
Before using this skill, ensure you have:
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"
}
}
}
}
Base URL: https://app.thumbcraft.io/api/v1
All requests require the header:
Authorization: Bearer YOUR_API_KEY
generate_thumbnailCreate a thumbnail from a text description.
Parameters:
prompt (required): Detailed description of the thumbnailyoutube_url (optional): YouTube URL for contextstyle_id (optional): Apply a saved styleface_ids (optional): Array of face IDs to includebrand_id (optional): Brand ID for colors/logoaspect_ratio (optional): "16:9" (default) or "9:16"Best practices for prompts:
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_videoAnalyze a YouTube video and get 5 thumbnail concepts with prompts.
Parameters:
youtube_url (required): Full YouTube URLReturns: Video summary and 5 thumbnail concepts with:
list_facesGet uploaded face models for personalized thumbnails.
Parameters:
active_only (optional): Only return trained facescreate_faceCreate a new face from an image URL. Requires training before use.
Parameters:
name (required): Display nameimage_url (required): Clear face photo URLlist_stylesGet saved thumbnail styles to apply to generations.
list_brandsGet brand assets (logos, colors) for consistent branding.
list_thumbnailsGet recent generated thumbnails.
Parameters:
limit (optional): Number to return (default: 10)generate_seo_titlesGenerate 10 SEO-optimized video titles from a YouTube URL.
Parameters:
youtube_url (required): YouTube video URLReturns: 10 titles with style labels:
generate_seo_descriptionGenerate a complete video description.
Parameters:
youtube_url (required): YouTube video URLReturns structured description with:
get_creditsCheck remaining credit balance.
analyze_video with the YouTube URLgenerate_thumbnail with the chosen concept's promptlist_styles to show available stylesgenerate_thumbnail with style_id parameteranalyze_video for thumbnail conceptsgenerate_thumbnailgenerate_seo_titles for title optionsgenerate_seo_description for the descriptiontrainingStatus)face_ids array to include multiple peopleCommon errors:
401 Unauthorized: Check API key402 Payment Required: Out of credits429 Too Many Requests: Rate limited, wait and retryInvalid YouTube URL: Ensure full URL formatOperations that consume credits:
generate_thumbnail: 1 creditCheck balance with get_credits before generating.