ggui

Overview

ggui provides a universal interface layer where AI agents describe UI needs in natural language and the system generates ephemeral, interactive interfaces via MCP. It requires no frontend code, React templates, or custom components. The project includes a reference server implementation that can be self-hosted, with packages for both server-side and client-side integration. The protocol is designed to be runtime-negotiated between AI agents and human users through MCP tools and WebSocket connections.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• ggui_push

  Push a UI to the user (natural-language prompt + data)

  Try:Create a customer dashboard showing sales metricsTry:Build a form for user feedback with rating and comments
• ggui_update

  Update props on an existing UI (no regeneration, ~200ms)

  Try:Update the dashboard with new sales dataTry:Change the form's validation rules
• ggui_handshake

  Initial session bootstrap

  Try:Initialize a new session for the user dashboardTry:Establish a connection for the feedback form
• ggui_search_blueprints

  Search for available UI blueprints

  Try:Find dashboard templates for analyticsTry:Search for form blueprints in the catalogue
• ggui_render_blueprint

  Render a specific blueprint with data

  Try:Render the sales dashboard blueprint with current dataTry:Generate a user profile form using the blueprint
• ggui_validate_blueprint

  Validate a blueprint's structure and requirements

  Try:Check if the dashboard blueprint is properly configuredTry:Validate the form blueprint before deployment

Comparable tools

Installation

# Install the CLI
npm install -g @ggui-ai/cli

# Create a new server
npm create ggui-server@latest my-app
cd my-app
npm install

# Start the server
npx ggui serve

{
  "mcpServers": {
    "ggui": {
      "url": "http://127.0.0.1:6781/mcp",
      "headers": { "Authorization": "Bearer dev" }
    }
  }
}

FAQ

What MCP tools does ggui provide?

ggui provides primary tools: ggui_push (to push UIs), ggui_update (to update existing UIs), and ggui_handshake (for initial session bootstrap), plus blueprint tools for catalogue lookups.

Can I use ggui without React?

Yes, you can embed UIs using an iframe pointing to the viewer URL, or use the @ggui-ai/mcp-client SDK for direct integration with any MCP-compatible agent runtime.

Compare ggui with