create_grid_container
Create grid-based containers for organizing lab samples and materials with precise positioning. Define dimensions like 8x12 for 96-well plates to structure microplates, freezer boxes, and position-specific storage systems.
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 |
|---|---|---|---|
| name | Yes | ||
| rows | Yes | ||
| columns | Yes | ||
| description | No | ||
| tags | No | ||
| can_store_containers | No | ||
| can_store_samples | No | ||
| parent_container_id | No |
Implementation Reference
- main.py:897-932 (handler)The primary handler implementation for the create_grid_container MCP tool. This function is decorated with @mcp.tool for automatic registration and wraps the RSpace inventory client to create grid-based containers (e.g., microplates) with specified dimensions, tags, and storage permissions.
@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 )