imgui-mcp

🖼️ 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 (widget.checked==true)

📦 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

Tool

Description

imgui_create_window

Create a window with title, position, size, and flags (menubar, no_resize, no_move, no_collapse, no_title_bar, always_auto_resize)

imgui_add_widget

Add any of 102 widget types to a window — supports nested children for containers

imgui_update_widget

Update a widget's value, text, checked state, color, label, or enabled state at runtime

imgui_remove_widget

Remove a widget by ID

imgui_remove_window

Remove a window and all its widgets

imgui_get_state

Get the full state of every window and widget (values, clicked, changed, hovered, focused)

imgui_clear_all

Remove all windows and widgets, reset to empty canvas

Tool

Description

imgui_screenshot

Capture the current frame as BMP — agent can inspect the image to see what it built

imgui_screenshot_widget

Capture with a specific widget's bounding box info for targeted inspection

imgui_screenshot_annotated

Capture with widget ID overlays drawn on the image for spatial reference

Tool

Description

imgui_click_widget

Simulate a mouse click on any widget (finds its rect center, injects click events)

imgui_type_text

Focus a widget and type text into it character by character

imgui_hover_widget

Move the virtual mouse to hover over a widget (triggers tooltips, highlights)

imgui_scroll_window

Inject mouse wheel scroll into a window

imgui_press_key

Press any key or combo: Enter, Tab, Escape, Ctrl+S, Shift+A, etc.

imgui_set_mouse_pos

Set the virtual mouse position in screen coordinates

imgui_focus_widget

Set keyboard focus to a specific widget for the next frame

Tool

Description

imgui_move_window

Move a window to new (x, y) coordinates

imgui_resize_window

Resize a window to new (w, h) dimensions

imgui_move_widget

Offset a widget's position via cursor offset

imgui_get_widget_rect

Get a widget's actual rendered bounding box in pixels

imgui_get_window_rect

Get a window's position and size

imgui_bring_to_front

Focus and raise a window to the top

imgui_set_widget_size

Override a widget's dimensions

imgui_get_layout

Get all widget bounding boxes in a window as structured data

Tool

Description

imgui_draw

Draw on named, composable canvas layers. Calls append by default (mode: replace resets one layer). Includes lines, rectangles, circles, triangles, text, polygons, Beziers, ellipses, arcs, and four-corner gradients

Tool

Description

imgui_add_hit_region

Add an invisible interactive shape (rect, circle, ellipse, polygon) that detects hover, click, drag, double-click, and wheel events. Supports transforms (position, rotation, scale).

imgui_remove_hit_region

Remove a hit region by id

imgui_update_hit_region

Update a hit region's shape, transform, or interaction flags

imgui_get_canvas_events

Drain canvas interaction events (hover, click, drag start/move/end, wheel, double-click) with positions and deltas

imgui_update_draw_command

Update a single draw command in a layer by index — change color, position, thickness without replacing the layer

imgui_transform_draw_layer

Apply translate, rotate, scale, or opacity to an entire draw layer

imgui_bind

Bind a widget value to a visual property (e.g. slider → draw layer opacity). Updates every frame automatically.

imgui_unbind

Remove bindings by source widget and/or target

imgui_set_callback

Declarative action: button click toggles visibility, switches scenes, or sets values — no polling round-trip

imgui_remove_callback

Remove declarative callbacks

Tool

Description

imgui_set_style

Apply a built-in theme: dark, light, or classic

imgui_set_theme

Apply an extended theme preset: fantasy (gold/amber), scifi (cyan/teal), retro (terminal green), minimal (clean white)

imgui_set_theme_color

Set any ImGui color by name: WindowBg, Button, Text, FrameBg, Header, Border, etc.

imgui_set_style_var

Set any style variable: FrameRounding, WindowRounding, ItemSpacing, FramePadding, IndentSpacing, ScrollbarSize, GrabMinSize, etc.

imgui_push_style_color

Push a temporary style color override

imgui_pop_style_color

Pop pushed style colors

imgui_set_background

Set the viewport background clear color

Tool

Description

imgui_animate

Tween any widget property (value, opacity, size, position) over time with easing: linear, ease_in, ease_out, ease_in_out, bounce, elastic, back — supports loop/ping-pong

imgui_stop_animation

Stop animations on a specific widget

imgui_stop_all_animations

Stop all active animations

Tool

Description

imgui_set_anchor

Anchor a window to the viewport: top_left, top_center, top_right, center_left, center, center_right, bottom_left, bottom_center, bottom_right — with pixel offset

imgui_set_widget_anchor

Anchor a widget within its window for responsive layout

imgui_set_viewport_size

Resize the application window to exact pixel dimensions

imgui_get_viewport_size

Get current viewport dimensions

imgui_set_resolution_preset

Resize to a preset: 720p, 1080p, 1440p, 4k, ultrawide (3440×1440), mobile (390×844), tablet (1024×768)

imgui_set_dpi_scale

Scale all UI sizes for HiDPI displays (1.0, 1.5, 2.0)

imgui_set_safe_area

Set safe area insets (top, bottom, left, right) that anchored windows respect

Tool

Description

imgui_load_texture

Load a BMP/PPM image as a GPU texture for Image/ImageButton widgets. Creates a checkerboard placeholder if file not found.

imgui_unload_texture

Free a loaded texture's GPU resources

imgui_load_font

Load a TTF/OTF font with a glyph-coverage preset, or merge it into another face as a symbol/icon fallback.

imgui_set_font

Switch the global ImGui font by ID, or restore the embedded default.

imgui_list_fonts

List loaded font IDs, paths, sizes, and the active font.

Tool

Description

imgui_undo

Undo the last add/remove/update/clear operation (50-deep stack)

imgui_redo

Re-apply an undone operation

imgui_save_snapshot

Save the current layout as a named snapshot

imgui_load_snapshot

Restore a previously saved snapshot

imgui_list_snapshots

List all snapshots with names, frame numbers, and widget counts

imgui_delete_snapshot

Delete a snapshot by name

Tool

Description

imgui_create_scene

Create a named scene that groups specific windows together

imgui_delete_scene

Delete a scene

imgui_switch_scene

Switch to a scene — only its windows are rendered

imgui_list_scenes

List all scenes and the active scene

imgui_set_window_layer

Set z-order layer for a window (higher = renders on top)

imgui_set_widget_visibility

Set conditional visibility: always, never, widget_id.checked==true, widget_id.value>0.5

imgui_set_window_visibility

Show or hide a window

Tool

Description

imgui_export_cpp

Generate standalone C++ ImGui code that recreates the current layout (with static variables for state)

imgui_export_lua

Generate Lua imgui binding code that recreates the layout

imgui_export_json

Serialize the complete live design: windows, widgets, font stack, active font, and tweens

imgui_import_json

Restore the complete design, including merged fonts and in-progress/looping animations

Tool

Description

imgui_show_demo

Toggle the ImGui demo window (showcases every widget interactively)

imgui_show_metrics

Toggle the metrics/debug window (draw calls, vertices, internal state)

imgui_show_about

Toggle the about window (version, credits, build info)

imgui_show_style_editor

Toggle the style editor (edit colors and sizes interactively)

Tool

Description

imgui_app_status

Check if the ImGui app is running, binary path, and version

imgui_drain_events

Retrieve pending native UI events with bounded batching and dropped-event accounting

imgui_get_input_state

Query mouse position, button states, keyboard state, hovered/active/focused items

imgui_clipboard

Get or set the system clipboard text

imgui_window_control

Low-level window ops: set_pos, set_size, set_collapsed, set_focus, set_bg_alpha, set_scroll

Category

Widget Types

Buttons

button, small_button, invisible_button, arrow_button, text_link, text_link_open_url

Text

text, text_colored, text_disabled, text_wrapped, label_text, bullet_text, separator_text

Input

input_text, input_text_multiline, input_text_with_hint, input_float, input_float2, input_float3, input_float4, input_int, input_int2, input_int3, input_int4, input_double

Sliders

slider_float, slider_float2, slider_float3, slider_float4, slider_int, slider_int2, slider_int3, slider_int4, slider_angle, vslider_float, vslider_int

Drag

drag_float, drag_float2, drag_float3, drag_float4, drag_float_range2, drag_int, drag_int2, drag_int3, drag_int4, drag_int_range2

Color

color_edit3, color_edit4, color_picker3, color_picker4, color_button

Combo & List

combo, listbox

Trees

tree_node, tree_node_ex, collapsing_header, selectable

Tables

table — with headers, rows, sorting, column resize, reordering

Menus

menu_bar, main_menu_bar, menu, menu_item — with shortcuts and checkmarks

Popups

popup, popup_modal

Tabs

tab_bar, tab_item — closable tabs with nested content

Containers

child_window — scrollable sub-regions, group — layout grouping

Plots

plot_lines, plot_histogram — with overlay text and scale control

Toggles

checkbox, checkbox_flags, radio_button

Progress

progress_bar — with custom overlay text

Layout

separator, same_line, new_line, spacing, dummy, indent, unindent, align_text_to_frame_padding, bullet

Values

value_bool, value_int, value_float

Tooltips

tooltip, set_item_tooltip

Images

image, image_button — with loaded textures

Widget

What it renders

health_bar

Labeled HP bar with green→yellow→red color gradient based on percentage, "HP: X/Y" overlay

mana_bar

Blue/purple MP bar with "MP: X/Y" overlay

inventory_grid

N×M grid of 48px slots with item labels, selected slot highlight, click events

dialogue_box

Bordered panel with speaker name, typewriter text reveal, numbered choice buttons

minimap

Dark bordered square with green player triangle at center, red entity dots from coordinate data

tooltip_card

Bordered card with rarity-colored title, wrapped description, stat lines

cooldown_radial

Circle with radial sweep showing remaining cooldown, centered label

notification_toast

Small rounded rect with opacity fade, positioned at top-right

skill_bar

Horizontal row of icon squares with keybind labels and cooldown overlays

quest_tracker

Panel with colored header, quest entries with individual progress bars

character_sheet

Tabbed panel with headers as tab names, key-value stat pairs from row data

Tool

Config File

Format

Claude Code

.mcp.json

JSON — mcpServers with ${CLAUDE_PROJECT_DIR}

Claude Desktop

Global config

JSON — mcpServers (absolute path required)

Cursor

.cursor/mcp.json

JSON — mcpServers with ${workspaceFolder}

VS Code / Copilot

.vscode/mcp.json

JSON — servers key with type: "stdio"

Windsurf

.windsurf/mcp.json

JSON — mcpServers (relative path)

omp (Oh My Pi)

.omp/mcp.json

JSON — mcpServers (relative path)

Cline

.cline/mcp.json

JSON — mcpServers with cwd + autoApprove

Roo Code

.roo/mcp.json

JSON — mcpServers with cwd + alwaysAllow

Zed

.zed/settings.json

JSON — context_servers with flat command

Gemini CLI

.gemini/settings.json

JSON — mcpServers (relative path)

Codex CLI

.codex/config.toml

TOML — [mcp_servers.imgui]

Continue

.continue/config.yaml

YAML — mcpServers as list

Augment

Global config

JSON — mcpServers