thumbnail — full tool reference
Thumbnail generation.
| Endpoint | https://thumbnail.mcp.devfellowship.com/mcp |
| Package | packages/dfl-mcp-thumbnail |
| Tools | 1 |
| Tool | Description |
|---|---|
generate_thumbnail | Render a gold-standard DevFellowship YouTube thumbnail (1280x720) via the youtube_gold layout. Layers, back to front: background_image -> behind_object (behind the character) -> character (alpha-cut photo on the right) -> tech logos (top-left) -> condensed bold title with green highlight (bottom-left). character_url MUST be a background-removed (alpha) photo; all image inputs must be public URLs the renderer can fetch (upload local files first). Returns the rendered PNG URL. |
generate_thumbnail
Section titled “generate_thumbnail”Generate YouTube Thumbnail
Render a gold-standard DevFellowship YouTube thumbnail (1280x720) via the youtube_gold layout. Layers, back to front: background_image -> behind_object (behind the character) -> character (alpha-cut photo on the right) -> tech logos (top-left) -> condensed bold title with green highlight (bottom-left). character_url MUST be a background-removed (alpha) photo; all image inputs must be public URLs the renderer can fetch (upload local files first). Returns the rendered PNG URL.
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | yes | Headline / SEO keyword. Rendered UPPERCASE, condensed bold, auto-fit. |
character_url | string | yes | Character photo URL with background ALREADY removed (alpha PNG). Placed large on the right. |
background_image | string | no | Full-bleed background image URL. Omit for the brand teal gradient. |
behind_object | string | no | No-bg object/mockup PNG URL, layered ABOVE the background but BEHIND the character. |
behind_object_box | object | no | Placement box for behind_object in 1280x720 reference px. Omit for full-canvas centered contain. |
screenshot_url | string | no | Optional legacy center screenshot layer (above background, below character). |
logos | enum[] | no | Tech-stack logo keys (top-left tiles). Allowed: react, tailwind, vite, typescript, javascript, nextjs, node, python, supabase, postgresql, docker, go. Inferred from title when omitted. |
highlight | string[] | no | Words to paint green in the title. Heuristic (longest content words) when omitted. |
character_brightness | number | no | Brightness multiplier for the character/person layer (CSS brightness()). Default 1.1. Range ~0.5-2.0; >1 brightens the person to pop against dark backgrounds. |
character_contrast | number | no | Contrast multiplier for the character/person layer (CSS contrast()). Default 1.15. Range ~0.5-2.0. |
width | number | no | Output width. Default 1280. |
height | number | no | Output height. Default 720. |