imgui-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@imgui-mcp design a game HUD with health bar, mana bar, and skill bar"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
The Problem
AI coding agents can generate UI code — but they can't see the result. They write ImGui calls blind, hope the layout works, and never iterate visually. Game UI development needs a feedback loop: place → preview → adjust → repeat.
Related MCP server: Pane
The Solution
imgui-mcp is a Model Context Protocol server that gives any AI agent a live, interactive Dear ImGui canvas with 84 tools, 102 widget types, and a visual feedback loop:
┌──────────────────────────────────────────────────────────────────┐
│ "Build a game HUD with health bar, inventory, and skill bar" │
└───────────────────────────────┬──────────────────────────────────┘
▼
┌─────────────┐ MCP ┌──────────┐ JSON ┌─────────────┐
│ AI Agent │◄──────────►│ server.py │◄────────►│ Live ImGui │
│ (any LLM) │ 84 tools │ 0 deps │ stdin/ │ SDL2+GL │
└─────────────┘ └──────────┘ stdout └──────┬───────┘
▲ │
│ screenshot (BMP) │
└─────────────────────────────────────────────────┘
Agent SEES what it builtThe agent creates widgets, takes a screenshot, sees the rendered result, and iterates — like a developer with eyes.
Features at a Glance
🖼️ Visual Feedback | Screenshot capture (full frame, widget-bound metadata, annotated overlays) — the agent sees its work |
🎮 Game UI Patterns | Health bars, mana bars, inventory grids, dialogue boxes, minimaps, cooldown radials, skill bars, quest trackers, character sheets, notification toasts, tooltip cards |
🖱️ Input Simulation | Click buttons, type text, hover widgets, scroll, press keys — test UI behavior programmatically |
✨ Animation | 7 easing functions, nested-widget property tweens, loop/ping-pong, and JSON round-trip persistence |
🎨 Theming | 7 presets (dark, light, classic, fantasy, sci-fi, retro, minimal) + per-color and per-variable customization |
📐 Layout | 9-point anchor system, resolution presets (720p → 4K + ultrawide + mobile), DPI scaling, safe areas |
🔄 Workflow | Undo/redo (50-deep), named snapshots, save/load/delete layout versions |
🎬 Scenes | Multi-window composition, z-order layers, conditional visibility ( |
📦 Export | Generate production C++, Lua, or complete JSON designs with fonts and live animations |
🖌️ Drawing | Lines, rects, circles, triangles, beziers, polylines, text — direct ImDrawList access |
🧩 102 Widgets | Every Dear ImGui widget + 11 game-specific patterns |
🔌 Zero Dependencies | Python server needs no pip packages. C++ app vendors ImGui. |
🪟 Native Polish | Dark themed Windows title bar, branded taskbar/title-bar icon, and HiDPI-aware windowing |
🔤 Font Stacks | Runtime TTF/OTF loading, Unicode coverage presets, and merged icon/symbol fallback faces |
Quick Start
Option A: Pre-built release (no compiler needed)
Download from Releases:
Linux:
tar -xzf imgui-mcp-*-linux-x64.tar.gz
cd imgui-mcp-*-linux-x64
./setup.sh # configures all 13 IDE/CLI toolsWindows:
Extract zip → double-click install.batOption B: Build from source
git clone https://github.com/SaloQT/imgui-mcp.git
cd imgui-mcp
uv sync # installs the pinned official MCP Python SDK
make build # requires: cmake, g++, libsdl2-dev, libgl1-mesa-dev
./setup.shVerify it works
uv run python demo.py # runs a full feature demonstrationAll 74 MCP Tools
Windows & Widgets (7)
Tool | Description |
| Create a window with title, position, size, and flags (menubar, no_resize, no_move, no_collapse, no_title_bar, always_auto_resize) |
| Add any of 102 widget types to a window — supports nested children for containers |
| Update a widget's value, text, checked state, color, label, or enabled state at runtime |
| Remove a widget by ID |
| Remove a window and all its widgets |
| Get the full state of every window and widget (values, clicked, changed, hovered, focused) |
| Remove all windows and widgets, reset to empty canvas |
Visual Feedback (3)
Tool | Description |
| Capture the current frame as BMP — agent can inspect the image to see what it built |
| Capture with a specific widget's bounding box info for targeted inspection |
| Capture with widget ID overlays drawn on the image for spatial reference |
Input Simulation (7)
Tool | Description |
| Simulate a mouse click on any widget (finds its rect center, injects click events) |
| Focus a widget and type text into it character by character |
| Move the virtual mouse to hover over a widget (triggers tooltips, highlights) |
| Inject mouse wheel scroll into a window |
| Press any key or combo: |
| Set the virtual mouse position in screen coordinates |
| Set keyboard focus to a specific widget for the next frame |
Window & Widget Manipulation (8)
Tool | Description |
| Move a window to new (x, y) coordinates |
| Resize a window to new (w, h) dimensions |
| Offset a widget's position via cursor offset |
| Get a widget's actual rendered bounding box in pixels |
| Get a window's position and size |
| Focus and raise a window to the top |
| Override a widget's dimensions |
| Get all widget bounding boxes in a window as structured data |
Drawing — ImDrawList (1)
Tool | Description |
| Draw on named, composable canvas layers. Calls append by default ( |
Interactive Canvas (10)
Tool | Description |
| Add an invisible interactive shape (rect, circle, ellipse, polygon) that detects hover, click, drag, double-click, and wheel events. Supports transforms (position, rotation, scale). |
| Remove a hit region by id |
| Update a hit region's shape, transform, or interaction flags |
| Drain canvas interaction events (hover, click, drag start/move/end, wheel, double-click) with positions and deltas |
| Update a single draw command in a layer by index — change color, position, thickness without replacing the layer |
| Apply translate, rotate, scale, or opacity to an entire draw layer |
| Bind a widget value to a visual property (e.g. slider → draw layer opacity). Updates every frame automatically. |
| Remove bindings by source widget and/or target |
| Declarative action: button click toggles visibility, switches scenes, or sets values — no polling round-trip |
| Remove declarative callbacks |
Style & Theming (7)
Tool | Description |
| Apply a built-in theme: dark, light, or classic |
| Apply an extended theme preset: fantasy (gold/amber), scifi (cyan/teal), retro (terminal green), minimal (clean white) |
| Set any ImGui color by name: |
| Set any style variable: |
| Push a temporary style color override |
| Pop pushed style colors |
| Set the viewport background clear color |
Animation (3)
Tool | Description |
| Tween any widget property (value, opacity, size, position) over time with easing: |
| Stop animations on a specific widget |
| Stop all active animations |
Layout & Responsiveness (7)
Tool | Description |
| Anchor a window to the viewport: |
| Anchor a widget within its window for responsive layout |
| Resize the application window to exact pixel dimensions |
| Get current viewport dimensions |
| Resize to a preset: |
| Scale all UI sizes for HiDPI displays (1.0, 1.5, 2.0) |
| Set safe area insets (top, bottom, left, right) that anchored windows respect |
Assets, Textures & Fonts (5)
Tool | Description |
| Load a BMP/PPM image as a GPU texture for Image/ImageButton widgets. Creates a checkerboard placeholder if file not found. |
| Free a loaded texture's GPU resources |
| Load a TTF/OTF font with a glyph-coverage preset, or merge it into another face as a symbol/icon fallback. |
| Switch the global ImGui font by ID, or restore the embedded |
| List loaded font IDs, paths, sizes, and the active font. |
Font paths are opened by the native renderer, so use a path visible to that process. For example, a Windows renderer launched from WSL accepts a Windows path:
imgui_load_font(id="ui", path="C:\\Windows\\Fonts\\segoeui.ttf", size_pixels=18)
imgui_load_font(id="symbols", path="C:\\Windows\\Fonts\\seguisym.ttf",
size_pixels=18, glyph_ranges="symbols", merge_into="ui")
imgui_set_font(id="ui")
imgui_list_fonts()
imgui_set_font(id="default")glyph_ranges accepts default, unicode, symbols, cyrillic, greek,
vietnamese, thai, japanese, korean, chinese_full, or
chinese_simplified. Dear ImGui 1.92 resolves Unicode dynamically; merging is
the important step when the primary face does not contain icon or symbol
glyphs. On Windows, Segoe UI Symbol is merged into Segoe UI automatically.
Fonts remain loaded for the renderer process lifetime. IDs are unique; choose a new ID when comparing another face or size.
Workflow — Undo/Redo & Snapshots (6)
Tool | Description |
| Undo the last add/remove/update/clear operation (50-deep stack) |
| Re-apply an undone operation |
| Save the current layout as a named snapshot |
| Restore a previously saved snapshot |
| List all snapshots with names, frame numbers, and widget counts |
| Delete a snapshot by name |
Scenes & Multi-Window (7)
Tool | Description |
| Create a named scene that groups specific windows together |
| Delete a scene |
| Switch to a scene — only its windows are rendered |
| List all scenes and the active scene |
| Set z-order layer for a window (higher = renders on top) |
| Set conditional visibility: |
| Show or hide a window |
Export & Import (4)
Tool | Description |
| Generate standalone C++ ImGui code that recreates the current layout (with static variables for state) |
| Generate Lua imgui binding code that recreates the layout |
| Serialize the complete live design: windows, widgets, font stack, active font, and tweens |
| Restore the complete design, including merged fonts and in-progress/looping animations |
Debug Windows (4)
Tool | Description |
| Toggle the ImGui demo window (showcases every widget interactively) |
| Toggle the metrics/debug window (draw calls, vertices, internal state) |
| Toggle the about window (version, credits, build info) |
| Toggle the style editor (edit colors and sizes interactively) |
System, Events & Input State (5)
Tool | Description |
| Check if the ImGui app is running, binary path, and version |
| Retrieve pending native UI events with bounded batching and dropped-event accounting |
| Query mouse position, button states, keyboard state, hovered/active/focused items |
| Get or set the system clipboard text |
| Low-level window ops: set_pos, set_size, set_collapsed, set_focus, set_bg_alpha, set_scroll |
All 102 Widget Types
Standard ImGui Widgets (91)
Category | Widget Types |
Buttons |
|
Text |
|
Input |
|
Sliders |
|
Drag |
|
Color |
|
Combo & List |
|
Trees |
|
Tables |
|
Menus |
|
Popups |
|
Tabs |
|
Containers |
|
Plots |
|
Toggles |
|
Progress |
|
Layout |
|
Values |
|
Tooltips |
|
Images |
|
Game UI Patterns (11)
Widget | What it renders |
| Labeled HP bar with green→yellow→red color gradient based on percentage, "HP: X/Y" overlay |
| Blue/purple MP bar with "MP: X/Y" overlay |
| N×M grid of 48px slots with item labels, selected slot highlight, click events |
| Bordered panel with speaker name, typewriter text reveal, numbered choice buttons |
| Dark bordered square with green player triangle at center, red entity dots from coordinate data |
| Bordered card with rarity-colored title, wrapped description, stat lines |
| Circle with radial sweep showing remaining cooldown, centered label |
| Small rounded rect with opacity fade, positioned at top-right |
| Horizontal row of icon squares with keybind labels and cooldown overlays |
| Panel with colored header, quest entries with individual progress bars |
| Tabbed panel with headers as tab names, key-value stat pairs from row data |
Supported IDE/CLI Tools
imgui-mcp ships project-level config files for every major AI coding tool. Clone the repo, open it in your tool, and the MCP server is already configured.
Tool | Config File | Format |
Claude Code |
| JSON — |
Claude Desktop | Global config | JSON — |
Cursor |
| JSON — |
VS Code / Copilot |
| JSON — |
Windsurf |
| JSON — |
omp (Oh My Pi) |
| JSON — |
Cline |
| JSON — |
Roo Code |
| JSON — |
Zed |
| JSON — |
Gemini CLI |
| JSON — |
Codex CLI |
| TOML — |
Continue |
| YAML — |
Augment | Global config | JSON — |
Run ./setup.sh (Linux/macOS) or .\setup.ps1 (Windows) to also install global configs for tools that need them.
Usage Examples
Game HUD
"Create a fantasy game HUD with health at 75%, mana at 60%, a 4×3 inventory grid, and a 5-slot skill bar."
imgui_create_window(id="hud", title="Game HUD", w=800, h=600, flags=["menubar"])
imgui_add_widget(window="hud", id="hp", widget_type="health_bar", value=0.75)
imgui_add_widget(window="hud", id="mp", widget_type="mana_bar", value=0.6)
imgui_add_widget(window="hud", id="inv", widget_type="inventory_grid",
int_value=4, int_values=[4,3],
items=["Sword","Shield","Potion","Bow","Arrow","Ring",...])
imgui_add_widget(window="hud", id="skills", widget_type="skill_bar",
int_value=5, items=["Q","W","E","R","F"],
values=[0, 0.3, 0, 0.7, 1.0])
imgui_set_theme(theme="fantasy")
imgui_screenshot() ← agent sees the result and iteratesAnimated Damage Flash
"Animate the health bar dropping from 75% to 20% with a bounce effect over 2 seconds."
imgui_animate(window="hud", widget="hp", property="value",
from=0.75, to=0.2, duration=2.0, ease="bounce")Export to Game Code
"Export this layout as C++ code I can drop into my game."
imgui_export_cpp(path="src/game_hud.cpp")
→ Generates a standalone render_game_hud() function with static variablesResponsive Testing
"Test the HUD at 4K resolution and mobile."
imgui_set_resolution_preset(preset="4k")
imgui_screenshot()
imgui_set_resolution_preset(preset="mobile")
imgui_screenshot()Architecture
imgui-mcp/
├── server.py Official Python SDK server — 84 tools
├── pyproject.toml Python package and MCP SDK dependency
├── uv.lock Reproducible Python dependency lock
├── src/
│ ├── types.h Shared enums (102 widget types), structs, globals
│ ├── main.cpp SDL2+OpenGL3 lifecycle, stdin reader, emit helpers
│ ├── render.cpp render_widget() — 102-case switch, nested containers
│ └── commands.cpp process_command() — all command handlers
├── vendor/ Dear ImGui v1.92.8 (vendored, MIT)
├── cmake/ MinGW cross-compilation toolchain
├── assets/windows/ Branded PNG/ICO and Windows resource manifest
├── tests/ Python bridge + native protocol regression suite
├── VERSION Authoritative release version
├── CMakeLists.txt Cross-platform build (Linux, macOS, Windows)
├── setup.sh Linux/macOS installer for all 13 tools
├── setup.ps1 Windows installer for all 13 tools
├── demo.py Full feature demonstration script
├── .mcp.json Claude Code config
├── .cursor/mcp.json Cursor config
├── .vscode/mcp.json VS Code / Copilot config
├── .windsurf/mcp.json Windsurf config
├── .omp/mcp.json omp config
├── .cline/mcp.json Cline config
├── .roo/mcp.json Roo Code config
├── .zed/settings.json Zed config
├── .gemini/settings.json Gemini CLI config
├── .codex/config.toml Codex CLI config
└── .continue/config.yaml Continue configWire protocol: MCP via the official Python SDK · stdio transport. Local stdio servers do not use OAuth; clients may display authentication as “Unsupported” or “N/A”, which is expected.
Building from Source
# Linux / macOS
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel
ctest --test-dir build --output-on-failure
# Windows (MSVC + vcpkg)
cmake -B build -DCMAKE_TOOLCHAIN_FILE=[vcpkg]/scripts/buildsystems/vcpkg.cmake
cmake --build build --config Release
# Windows (cross-compile from Linux)
cmake -B build-win -DCMAKE_TOOLCHAIN_FILE=cmake/mingw-w64-x86_64.cmake
cmake --build build-winRequirements: CMake 3.16+, C++17 compiler, SDL2, OpenGL
Trust Model
imgui-mcp is a local development tool. Several tools intentionally read or write paths available to the server process (screenshots, textures, layouts, and code exports), so connect only trusted MCP clients and run it with the least filesystem privileges your project needs.
License
MIT — see LICENSE. Dear ImGui is vendored under its own MIT license.
Available Tools
84 toolsimgui_add_hit_regionA
Add an interactive hit region to a window. Hit regions are invisible shapes that detect mouse hover, click, drag, double-click, and wheel events. Use with imgui_get_canvas_events to read interactions. Shapes: rect, circle, ellipse, polygon.
Inputs: id (required), shape (required), window (required), p1, +5 more.
imgui_add_widgetC
Add a widget to an ImGui window. Supports 80+ widget types including buttons, text, inputs, sliders, drags, color pickers, combos, trees, tables, menus, popups, plots, containers, and tooltips.
Inputs: id (required), window (required), widget_type (required), dir, +31 more.
imgui_animateB
Animate a widget property over time using a tween/animation. Supports multiple easing functions and looping.
Inputs: widget (required), window (required), property (required), to, +4 more.
imgui_app_statusA
Check if the ImGui application is running and get its status including binary path and availability.
Inputs: no named parameters.
imgui_bindA
Bind a widget's value to a visual property. Each frame the source widget's property is read, scaled, offset, and written to the target. Example: bind a slider's value to a draw layer's opacity.
Inputs: window (required), target_id (required), target_type (required), source_widget (required), +4 more.
imgui_bring_to_frontB
Bring a window to the front and give it focus
Inputs: id (required).
imgui_clear_allB
Remove all windows and widgets, resetting to empty state
Inputs: no named parameters.
imgui_click_widgetB
Simulate a mouse click on a widget by its ID
Inputs: id (required), window (required), button.
imgui_clipboardC
Get or set the system clipboard text via ImGui
Inputs: action (required), text.
imgui_create_sceneB
Create a named scene that controls which windows are visible together
Inputs: name (required), windows (required).
imgui_create_windowB
Create a new ImGui window. Windows are containers for widgets. Supports positioning, sizing, and window flags.
Inputs: id (required), title (required), h, w, +3 more.
imgui_delete_sceneC
Delete a scene by name
Inputs: name (required).
imgui_delete_snapshotC
Delete a saved snapshot by name
Inputs: name (required).
imgui_drain_eventsA
Drain a bounded batch of native UI events. Returns the events, remaining queue depth, and the number dropped since the previous drain.
Inputs: max_events.
imgui_drawB
Append draw commands to a named layer in a window. Repeated calls preserve earlier geometry by default. Supports lines, shapes, gradients, ellipses, arcs, text, polygons, and bezier curves.
Inputs: window (required), commands (required), id, mode.
imgui_export_cppB
Export the current UI layout as C++ ImGui code that recreates all windows and widgets with their current values.
Inputs: path.
imgui_export_jsonA
Export the current UI layout as structured JSON with version info, window properties, and all widget definitions.
Inputs: path.
imgui_export_luaA
Export the current UI layout as Lua ImGui bindings code that recreates all windows and widgets with their current values.
Inputs: path.
imgui_focus_widgetC
Set keyboard focus to a widget (it will receive focus on the next frame)
Inputs: id (required), window (required).
imgui_get_canvas_eventsA
Drain canvas interaction events from hit regions. Returns hover, click, drag (start/move/end), wheel, and double-click events with positions and deltas. Events are consumed on read.
Inputs: max_events.
imgui_get_input_stateB
Query input state: mouse position, mouse buttons, keyboard keys, and item interaction states.
Inputs: queries (required).
imgui_get_layoutC
Get the layout of all widgets in a window with their bounding boxes
Inputs: window (required).
imgui_get_stateA
Get the current state of all windows and widgets. Returns values, checked states, text content, selected indices, and interaction flags (clicked, changed, hovered, active, focused).
Inputs: no named parameters.
imgui_get_viewport_sizeA
Get the current viewport (SDL window) dimensions
Inputs: no named parameters.
imgui_get_widget_rectA
Get the actual rendered bounding box of a widget in pixel coordinates
Inputs: id (required), window (required).
imgui_get_window_rectB
Get the position and size of a window
Inputs: id (required).
imgui_hover_widgetC
Move the mouse cursor to hover over a widget
Inputs: id (required), window (required).
imgui_import_jsonA
Import a UI layout from JSON (same format as imgui_export_json). Clears the current layout and recreates all windows and widgets.
Inputs: json, path.
imgui_list_fontsB
List loaded fonts, their native paths and sizes, and which font is active.
Inputs: no named parameters.
imgui_list_scenesA
List all scenes and their window lists, plus the active scene
Inputs: no named parameters.
imgui_list_snapshotsA
List all saved snapshots with their names, frame numbers, and widget counts
Inputs: no named parameters.
imgui_load_fontB
Load a TTF or OTF font into the live ImGui atlas under a stable ID. Use imgui_set_font to make it the global default.
Inputs: id (required), path (required), merge_into, size_pixels, +1 more.
imgui_load_snapshotA
Restore a previously saved snapshot by name. The current state is pushed to the undo stack before restoring.
Inputs: name (required).
imgui_load_textureA
Load a texture from a BMP or PPM file. If the file doesn't exist or is unsupported, creates a 64x64 checkerboard placeholder texture.
Inputs: id (required), path (required).
imgui_move_widgetC
Move a widget by applying a cursor offset before rendering
Inputs: id (required), window (required), offset_x (required), offset_y (required).
imgui_move_windowB
Move a window to a new position
Inputs: x (required), y (required), id (required).
imgui_pop_style_colorC
Pop style color overrides from the style stack for a specific window or widget.
Inputs: target (required), count.
imgui_press_keyA
Simulate a key press and release. Supports single keys and modifier combos. Examples: 'Enter', 'Tab', 'Escape', 'Ctrl+S', 'Shift+A', 'Ctrl+Shift+Z'
Inputs: key (required).
imgui_push_style_colorB
Push a style color override onto the style stack for a specific window or widget. Must be balanced with imgui_pop_style_color.
Inputs: color (required), target (required), col_idx (required).
imgui_redoA
Redo the last undone operation. Re-applies the state that was reversed by imgui_undo.
Inputs: no named parameters.
imgui_remove_callbackB
Remove declarative callbacks. Filter by trigger_widget and/or action.
Inputs: action, trigger_widget.
imgui_remove_hit_regionB
Remove a hit region by its id
Inputs: id (required).
imgui_remove_widgetC
Remove a widget from a window
Inputs: id (required), window (required).
imgui_remove_windowB
Remove a window and all its widgets
Inputs: id (required).
imgui_resize_windowC
Resize a window to new dimensions
Inputs: h (required), w (required), id (required).
imgui_save_snapshotA
Save the current layout state as a named snapshot. Snapshots can be restored later with imgui_load_snapshot.
Inputs: name.
imgui_screenshotB
Capture a screenshot of the current ImGui frame and save it as a BMP file.
Inputs: path, format.
imgui_screenshot_annotatedB
Capture a screenshot with widget ID overlays for debugging and inspection.
Inputs: path.
imgui_screenshot_widgetB
Capture a screenshot with information about a specific widget's bounds. Returns the screenshot path and widget location data.
Inputs: widget (required), window (required), path.
imgui_scroll_windowC
Scroll the mouse wheel over a window
Inputs: window (required), delta_y.
imgui_set_anchorB
Set a window's anchor position relative to the viewport (e.g. top_left, center, bottom_right)
Inputs: anchor (required), window (required), offset_x, offset_y.
imgui_set_backgroundA
Set the background clear color of the viewport
Inputs: color (required).
imgui_set_callbackA
Set a declarative callback action that fires automatically when a widget event occurs. Actions: toggle_visibility, set_visibility, set_value, switch_scene. No polling round-trip needed.
Inputs: action (required), window (required), trigger_widget (required), params, +1 more.
imgui_set_dpi_scaleC
Set the DPI/UI scale factor for all ImGui sizes
Inputs: scale (required).
imgui_set_fontB
Set the global default font by loaded ID. Use 'default' to restore Dear ImGui's embedded font.
Inputs: id (required).
imgui_set_mouse_posC
Set the mouse cursor position in screen coordinates
Inputs: x (required), y (required).
imgui_set_resolution_presetB
Resize the viewport to a common resolution preset
Inputs: preset (required).
imgui_set_safe_areaB
Set safe area insets (in pixels) that anchored windows will respect
Inputs: top (required), left (required), right (required), bottom (required).
imgui_set_styleC
Set the ImGui style theme. Choose from built-in themes (dark, light, classic) or provide custom color overrides.
Inputs: theme (required), colors.
imgui_set_style_varC
Set an ImGui style variable. Float vars: FrameRounding, WindowRounding, IndentSpacing, ScrollbarSize, GrabMinSize, etc. Vec2 vars: FramePadding, ItemSpacing, WindowPadding, etc.
Inputs: value (required), var_name (required).
imgui_set_themeA
Apply a theme preset to the ImGui interface. Available themes: dark, light, classic, fantasy (gold/amber accents), scifi (cyan/teal accents), retro (green terminal style), minimal (white, thin borders, no rounding).
Inputs: theme (required).
imgui_set_theme_colorA
Set a specific ImGui style color by name. Color names include: Text, WindowBg, FrameBg, Button, ButtonHovered, ButtonActive, Header, HeaderHovered, HeaderActive, Border, CheckMark, SliderGrab, etc.
Inputs: color (required), col_name (required).
imgui_set_viewport_sizeC
Resize the application viewport (SDL window) to specific pixel dimensions
Inputs: width (required), height (required).
imgui_set_widget_anchorB
Set a widget's anchor position for responsive layout within its window
Inputs: anchor (required), widget (required), window (required), offset_x, +1 more.
imgui_set_widget_sizeC
Set the size of a widget
Inputs: id (required), width (required), height (required), window (required).
imgui_set_widget_visibilityB
Set conditional visibility on a widget. Conditions: 'always', 'never', 'widget_id.checked==true', 'widget_id.value>0.5'
Inputs: widget (required), window (required), condition (required).
imgui_set_window_layerB
Set the render layer (z-order) of a window. Higher layers render on top.
Inputs: layer (required), window (required).
imgui_set_window_visibilityC
Show or hide a window by setting its open state
Inputs: window (required), visible (required).
imgui_show_aboutC
Show or hide the ImGui about window (version info, credits)
Inputs: show (required).
imgui_show_demoB
Show or hide the ImGui demo window (showcases all available widgets)
Inputs: show (required).
imgui_show_metricsC
Show or hide the ImGui metrics/debug window (draw calls, vertices, etc.)
Inputs: show (required).
imgui_show_style_editorC
Show or hide the ImGui style editor window (edit colors and sizes interactively)
Inputs: show (required).
imgui_stop_all_animationsA
Stop and remove all active animations across all windows
Inputs: no named parameters.
imgui_stop_animationB
Stop animations for a specific widget, or all animations in a window if widget is omitted.
Inputs: window (required), widget.
imgui_switch_sceneA
Switch to a named scene, showing only its windows
Inputs: name (required).
imgui_transform_draw_layerB
Apply a transform to an entire draw layer: translate, rotate, scale, or set opacity. Transforms persist until changed and apply to all draw commands in the layer.
Inputs: window (required), layer, scale, opacity, +2 more.
imgui_type_textA
Type text into a widget (focuses it first, then injects characters)
Inputs: id (required), text (required), window (required).
imgui_unbindA
Remove bindings. Filter by source_widget and/or target_id, or omit both to remove all.
Inputs: target_id, source_widget.
imgui_undoA
Undo the last destructive operation (add/remove/update widget, remove window, clear all). The undone state is pushed to the redo stack.
Inputs: no named parameters.
imgui_unload_textureA
Unload a previously loaded texture and free its GPU resources.
Inputs: id (required).
imgui_update_draw_commandB
Update a single draw command in a named draw layer without replacing the entire layer. Specify the command index and the fields to change.
Inputs: index (required), fields (required), window (required), layer.
imgui_update_hit_regionB
Update a hit region's shape, transform, or interaction flags. Only provided fields are updated.
Inputs: id (required), p1, p2, points, +2 more.
imgui_update_widgetB
Update an existing widget's properties. Can update value, text, checked state, label, content, color, items, selected index, enabled state, and plot data.
Inputs: id (required), window (required), max, min, +20 more.
imgui_window_controlC
Control a window's properties: position, size, collapsed state, focus, background alpha, or scroll position.
Inputs: id (required), action (required), value.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 84 tools
Most tools have clearly distinct purposes. There is some overlap between set_style/set_theme/set_theme_color/push_style_color and between show/hide variants (show_demo, show_metrics, window_control), but descriptions are specific enough to differentiate them. The redraw between set_window_visibility, move_window, resize_window, and window_control creates some boundary ambiguity, but each is targeted at a distinct use case.
All tools use the consistent verb_noun pattern with the imgui_ prefix. Verbs like get_, set_, add_, remove_, create_, delete_, list_, load_, save_, export_, import_, show_, push_, pop_, move_, resize_, update_, stop_ are used predictably. The only minor inconsistency is some tools use 'set_' where 'update_' might fit (e.g., set_widget_size vs update_widget), but the pattern is overwhelmingly consistent.
With 84 tools, this is far beyond the typical 3-15 well-scoped range. While each tool serves a distinct purpose in a comprehensive remote-UI-control server, the sheer size makes it unwieldy for an agent. The count is justified by the breadth of functionality, but it exceeds the 'heavy' threshold significantly. However, for a purpose as broad as full ImGui manipulation, every tool arguably earns its place.
The tool surface is extremely comprehensive, covering widget CRUD (add/update/remove), window management, scene management, snapshots, undo/redo, input simulation, drawing, styling, fonts, themes, animation, binding, callbacks, and hit regions. For an ImGui remote-control server, this is remarkably complete with no obvious dead ends. One could argue some overlap between set_style/set_theme/theme_color/define_style duplicates, but overall the coverage is thorough.
Maintenance
Related MCP Connectors
Your AI agent designs editable, clickable UI prototypes on a live canvas.
Agent-Native design tool - create and edit visual designs with agent assistance
A visual brain for your agents: live, reusable UI fragments and skills to pull into code.
A design agent in your coding agent's loop: briefs each screen, reviews UX and visual quality.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables AI agents to interact with Unity projects through multimodal vision, code analysis, asset management, and scene manipulation. Supports real-time Unity editor control, project search, script creation, and visual debugging through screenshots.32MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to create visual, interactive interfaces with diagrams, structured input forms, and persistent state management instead of text-only responses.7-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to query and control the Unity Editor, supporting scene management, GameObject manipulation, asset browsing, play mode control, and real-time editor operations through 52+ tools.1MIT
- AlicenseAqualityDmaintenanceLets AI agents visually inspect web elements, test CSS edits in real-time, and iterate until pixel-perfect, functioning like browser DevTools for debugging UI issues.14 npm1MIT