Create A2UI Surface
a2ui_create_surfaceCreate a UI container for A2UI components. Establish the required surface before adding components to render and display.
Instructions
Create a new A2UI surface (UI container) for rendering components.
A surface is the top-level container for A2UI components. You must create a surface before adding components to it.
Args:
surface_id (string): Unique identifier for the surface
catalog_id (string, optional): Component catalog to use
Returns: JSON message confirming surface creation
Example: Create a surface for a booking form: { "surface_id": "booking_form" }
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"surface_id": "<surface_id>"
},
"name": "a2ui_create_surface"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| catalog_id | No | Component catalog ID. Defaults to standard A2UI catalog. | https://a2ui.dev/specification/0.9/standard_catalog_definition.json |
| surface_id | Yes | Unique identifier for the surface (e.g., 'booking_form', 'user_profile') |