create_grid_container
Create grid-based containers for organizing position-specific storage like microplates and freezer boxes by defining exact row and column dimensions.
Instructions
Creates a grid-based container with specific positioning
Usage: Create microplates, freezer boxes, or other position-specific storage Dimensions: Define exact grid size (e.g., 8x12 for 96-well plate) Positioning: Items placed at specific coordinates (row, column)
Returns: Created container information with grid specifications
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| can_store_containers | No | ||
| can_store_samples | No | ||
| columns | Yes | ||
| description | No | ||
| name | Yes | ||
| parent_container_id | No | ||
| rows | Yes | ||
| tags | No |
Implementation Reference
- main.py:897-932 (handler)The core handler function decorated with @mcp.tool, which defines the input schema via type annotations and docstring, registers the tool, and implements the logic by preparing tags and location before calling the underlying inv_cli.create_grid_container API.@mcp.tool(tags={"rspace", "inventory", "containers"}) def create_grid_container( name: str, rows: int, columns: int, description: str = None, tags: List[str] = None, can_store_containers: bool = True, can_store_samples: bool = True, parent_container_id: Union[int, str] = None ) -> dict: """ Creates a grid-based container with specific positioning Usage: Create microplates, freezer boxes, or other position-specific storage Dimensions: Define exact grid size (e.g., 8x12 for 96-well plate) Positioning: Items placed at specific coordinates (row, column) Returns: Created container information with grid specifications """ tag_objects = i.gen_tags(tags) if tags else [] location = i.TopLevelTargetLocation() if parent_container_id: location = i.ListContainerTargetLocation(parent_container_id) return inv_cli.create_grid_container( name=name, row_count=rows, column_count=columns, description=description, tags=tag_objects, can_store_containers=can_store_containers, can_store_samples=can_store_samples, location=location )