How Widgets Work
When a tool returns a widget, the MCP client renders it inline:Defining Widgets
Widget support depends on the MCP client. Clients that don’t support widgets will fall back to showing the raw JSON response.
Use Cases
E-Commerce
Product grids, cart summaries, checkout forms with payment inputs.
Dashboards
Real-time charts, KPI cards, data tables with sorting and filtering.
Forms
Multi-step forms, file uploads, signature capture.
Maps
Location pickers, route visualization, geospatial data display.
Widgets + Stages
Widgets are especially powerful with staged workflows. Each stage can present a different UI:| Stage | Widget | User sees |
|---|---|---|
| Browse | Product grid | Browsable catalog with filters |
| Cart | Cart summary | Items with quantities and remove buttons |
| Checkout | Payment form | Credit card input and order confirmation |