pixoo-mcp-server

---

Tools

Seven tools covering the full display pipeline — from quick styled text to full layered scene composition, device control, and initial setup:

Tool	Description
pixoo_display_text	Render styled text (theme, gradient, shadow, outline, auto-fit) onto the display and push it. Returns the rendered frame as an image.
pixoo_compose_scene	Compose a full scene: layered elements (text, icons, widgets, shapes, bitmaps, images, sprites) with per-element effects and keyframes, static or animated. Returns the rendered scene as an image.
pixoo_push_image	Load an image (absolute local path or https URL), resize it to the LED grid, and push it. Returns the downsampled result as an image.
pixoo_overlay_text	Set or clear a device-native scrolling text overlay. Uses device-rendered fonts; overlays persist across channel switches until cleared.
pixoo_control_device	Read or change device state: brightness, screen on/off, channel, or clock face. Call with no params for a status read.
pixoo_discover_devices	Find Pixoo devices on the local network via Divoom's cloud discovery endpoint. Run once during setup to find device IPs.
pixoo_design_brief	Return craft guidance and live device context for a design topic. Covers legibility rules, palette discipline, layout zones, animation budget, and pre-filled next-tool suggestions.

pixoo_display_text

The primary tool for text-only display. Covers the 80% case — styled text with quality defaults.

• Named scene themes set background gradient and text palette in one parameter (midnight, ember, claude, ice, neon, forest, mono)
• Style block: gradient palette ramps (ember, ice, neon, fire, lavender, claude, mono), drop shadow, 1px outline for legibility, integer scale multiplier for block-letter weight
• Semantic positioning: x: "center", y: "bottom" — no manual pixel math
• Auto-fit overflow: tries 5×7 → 3×5 → scroll; every fit decision reported in layout[]
• Returns the rendered frame as an image content block so you see it immediately
• Optional brightness convenience parameter applied before push

---

pixoo_compose_scene

Full scene composition with the complete element vocabulary.