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.

Related