> ## 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

> An open MCP framework for generative UI experiences

SuperModel is an open-source framework that enables [MCP](https://modelcontextprotocol.org) 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](https://modelcontextprotocol.org) 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](https://docs.mintmcp.com/blog/understanding-mcp-gateways-ai-infrastructure), [MCP UI](https://mcp-ui.dev), and generative UI frameworks like [AG-UI](https://ag-ui.com), SuperModel creates a seamless zero-inference agentic UI pipeline with nominal server costs.

As shown in the [multi-app workflow example](/examples/multi-app-workflow), 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.

<CardGroup cols={2}>
  <Card title="Zero Server Costs" icon="dollar-sign" href="/concepts/zero-inference">
    All LLM inference happens on the client side through MCP sampling. Servers never pay for AI computation.
  </Card>

  <Card title="Dynamic UI Generation" icon="wand-magic-sparkles" href="/examples/hello-world">
    Generate interactive interfaces on-demand based on user requests and context.
  </Card>

  <Card title="Context-Aware Routing" icon="route" href="/concepts/gateway-pattern">
    Intelligent app selection that considers user intent and accumulated context.
  </Card>

  <Card title="Seamless App Handoffs" icon="arrow-right-arrow-left" href="/examples/context-handoff">
    Context flows between different specialized apps for complete user journeys.
  </Card>
</CardGroup>

## How It Works

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

<Steps>
  <Step title="Request Routing">
    Server uses MCP sampling to ask client's LLM which UI tool is best for the request
  </Step>

  <Step title="Tool Selection">
    Client's LLM analyzes available tools and returns routing decision
  </Step>

  <Step title="UI Generation">
    Selected tool uses MCP sampling to generate AG-UI compatible code
  </Step>

  <Step title="Client Rendering">
    Client renders interactive UI using AG-UI + MCP-UI integration
  </Step>
</Steps>

## Key Benefits

<AccordionGroup>
  <Accordion title="Bespoke User Experiences">
    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.
  </Accordion>

  <Accordion title="Complete Zero-Inference Architecture">
    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.
  </Accordion>

  <Accordion title="Modular Framework Support">
    Built to work with AG-UI initially, but designed to support any generative UI framework through pluggable adapters.
  </Accordion>

  <Accordion title="Context-Aware Workflows">
    Enables complex multi-app journeys where each app builds on previous interactions, creating seamless user experiences.
  </Accordion>

  <Accordion title="MCP Ecosystem Integration">
    Leverages existing MCP infrastructure including servers, tools, and sampling capabilities.
  </Accordion>
</AccordionGroup>

## Quick Start

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

<Card title="Quick Start Guide" icon="rocket" href="/quickstart">
  Set up your first SuperModel gateway server and generate your first UI app.
</Card>