Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.supermodel.network/llms.txt

Use this file to discover all available pages before exploring further.

SuperModel is an open-source framework that enables MCP clients to utilize interactive, generative UI apps dynamically selected to best help the user accomplish their goal. These agentic UI apps are provided by “app store” MCP servers that require no inference on the server side, instead using MCP sampling to delegate all reasoning to the client, both for the selection of which apps to provide and for the rendering of generative UI components. By combining the MCP gateway pattern, MCP UI, and generative UI frameworks like AG-UI, SuperModel creates a seamless zero-inference agentic UI pipeline with nominal server costs. As shown in the multi-app workflow example, the generative UI apps delivered via SuperModel can facilitate emergent user journeys, as the results of one generative UI app can be used to inform the selection and rendering of the next app in multi-step user workflows.

Zero Server Costs

All LLM inference happens on the client side through MCP sampling. Servers never pay for AI computation.

Dynamic UI Generation

Generate interactive interfaces on-demand based on user requests and context.

Context-Aware Routing

Intelligent app selection that considers user intent and accumulated context.

Seamless App Handoffs

Context flows between different specialized apps for complete user journeys.

​
How It Works

SuperModel operates through multiple layers, each using MCP sampling to delegate reasoning to the client:
1

Request Routing

Server uses MCP sampling to ask client’s LLM which UI tool is best for the request
2

Tool Selection

Client’s LLM analyzes available tools and returns routing decision
3

UI Generation

Selected tool uses MCP sampling to generate AG-UI compatible code
4

Client Rendering

Client renders interactive UI using AG-UI + MCP-UI integration

​
Key Benefits

MCP UI provides a way for MCP servers to deliver visual UI components to the client. SuperModel takes this a step further by facilitating bespoke generative user interfaces. For example, while an MCP UI server might return a calculator component, SuperModel can facilitate a calculator UI component customized specifically for the user’s prompt.
Unlike traditional approaches that require server-side LLMs for routing and generation, SuperModel uses MCP sampling for ALL decision-making, eliminating server inference costs entirely.
Built to work with AG-UI initially, but designed to support any generative UI framework through pluggable adapters.
Enables complex multi-app journeys where each app builds on previous interactions, creating seamless user experiences.
Leverages existing MCP infrastructure including servers, tools, and sampling capabilities.

​
Quick Start

Ready to build with SuperModel? Get started with our quick setup guide.

Quick Start Guide

Set up your first SuperModel gateway server and generate your first UI app.