ThumbnailGPT
ThumbnailGPT helps YouTube creators generate professional, eye-catching thumbnails using AI. Users can turn video ideas, titles, scripts, and reference images into custom thumbnails, maintain consistent facial likeness using persona references, recreate existing thumbnail styles, and customize scenes, lighting, and composition. Through MCP integration, creators can generate thumbnails directly from compatible AI assistants without switching tools.
Hosted MCP Server
npx add-mcp 'https://mcp.thumbnailgpt.com'Installs into Claude Code, Codex, Cursor and more
Documentation
ThumbnailGPT Developer & API Documentation
Official developer reference for ThumbnailGPT. CLI commands, Model Context Protocol (MCP) streamable endpoints, API keys, and SDK integration guides.
Canonical: https://thumbnailgpt.com/docs Last updated: 2026-11-05
The ThumbnailGPT Developer Platform enables developers, automation pipelines, and autonomous AI agents to generate, recreate, and edit YouTube thumbnails programmatically.
Quickstart
1. Generate an API Key
Create a Personal API Key with prefix tgpt_live_ in your Account Settings.
2. Run via CLI
# Zero-install one-off execution
npx -y thumbnailgpt generate --prompt "10 AI Tools That Will Replace You in 2026" --ratio 16:9
# Install globally
npm install -g thumbnailgpt
thumbnailgpt --version
Model Context Protocol (MCP) Configuration
ThumbnailGPT provides an official MCP server adhering to the Model Context Protocol specification.
- Remote Streamable HTTP URL:
https://mcp.thumbnailgpt.com - Local Stdio Command:
npx -y thumbnailgpt mcp
Example Client Config (claude_desktop_config.json or Cursor mcp.json)
{
"mcpServers": {
"thumbnailgpt": {
"url": "https://mcp.thumbnailgpt.com",
"headers": {
"Authorization": "Bearer tgpt_live_YOUR_API_KEY_HERE"
}
}
}
}
Available MCP Tools
thumbnailgpt_generate: Generate a complete thumbnail from video concept, text, and aspect ratio (16:9 or 9:16).thumbnailgpt_recreate: Recreate and remix an existing thumbnail from a public YouTube video URL or image link.thumbnailgpt_edit: Apply conversational inpainting to adjust scene lighting, elements, or typography.thumbnailgpt_list_personas: Fetch available creator character face profiles for consistent likeness.thumbnailgpt_get_credits: Inspect account credit balance.