ThumbnailGPT

ThumbnailGPT ajuda criadores do YouTube a gerar miniaturas profissionais e chamativas usando IA. Os usuários podem transformar ideias de vídeos, títulos, roteiros e imagens de referência em miniaturas personalizadas, manter a semelhança facial consistente usando referências de persona, recriar estilos de miniaturas existentes e personalizar cenas, iluminação e composição. Por meio da integração com MCP, os criadores podem gerar miniaturas diretamente de assistentes de IA compatíveis, sem precisar trocar de ferramenta.

Servidor MCP hospedado

npx add-mcp 'https://mcp.thumbnailgpt.com'

Instala no Claude Code, Codex, Cursor e outros

Documentação

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