# 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](https://thumbnailgpt.com/studio?settings=api-key).

### 2. Run via CLI
```bash
# 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`)
```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
- [AI Agents Directory](https://thumbnailgpt.com/agents)
- [Authentication Documentation](https://thumbnailgpt.com/auth.md)
- [OpenAPI Spec](https://thumbnailgpt.com/.well-known/api-catalog)
- [Home](https://thumbnailgpt.com/)
