pConAI/Documentation
Back to main page

Exhaustive Tool & Capability Reference

To provide developers and advanced users with complete transparency, here is the exhaustive list of all 20+ capabilities and tools exposed by the pConAI engine via MCP.

This reference explains exactly what each tool does and how it can be utilized in your workflows.

1. Catalog & Object Management

Tools responsible for finding, inserting, and managing physical objects in the scene.

catalog-search

  • Function: Semantically searches the global OFML catalog database.
  • Usage: Used to find items when the exact article ID is unknown. It supports filtering by manufacturer, product family, and abstract semantic descriptions (e.g., "ergonomic task chair").

catalog-insert

  • Function: Places a specific article into the 3D space using its unique Article ID.
  • Usage: Executes the physical insertion. Can handle multiple insertions simultaneously if passed an array of coordinates.

duplicate-selection

  • Function: Clones currently selected objects or specified object IDs.
  • Usage: Ideal for creating arrays or rapidly populating a space without re-querying the catalog.

delete-selection

  • Function: Removes items from the scene graph.
  • Usage: Triggers automatically on commands like "Remove the coffee table".

2. Parametric & Material Customization

Tools for altering the physical and visual properties of objects.

article-property-read

  • Function: Queries the available parametric properties of an object.
  • Usage: Before modifying a desk, the agent uses this to check if "width" and "depth" are valid parameters for that specific manufacturer's model.

article-property-edit

  • Function: Modifies the dimensional, structural, or functional parameters of an object.
  • Usage: "Set the desk height to 75cm."

materials-and-colors

  • Function: Applies global material mappings to generic objects or architectural elements.
  • Usage: Used for painting walls, changing floor textures, or applying solid colors.

chair-article-materials

  • Function: A specialized material tool specifically for complex upholstered items.
  • Usage: Allows for multi-material mapping, such as setting the seat back to mesh, the seat pan to fabric, and the casters to hard-floor variants.

3. Architecture & Geometry

Tools for creating the physical envelope of the space.

room-envelope

  • Function: Generates standard room boundaries (walls, floor, ceiling).
  • Usage: Accepts width, depth, and height parameters to instantly draft a room.

geometry-creation

  • Function: Creates basic primitive shapes (cubes, cylinders, spheres) and handles CAD Boolean operations.
  • Usage: Used for drafting custom architectural features like pillars, custom partitions, or podiums.

4. Space Planning & Smart Layouts

Advanced algorithmic tools that place multiple items based on spatial context and ergonomics.

seating-group

  • Function: Generates a basic cluster of seating around a focal point.
  • Usage: "Create a lounge seating group with 4 armchairs."

chair-table-placement

  • Function: Pairs seating with workstations or dining tables algorithmically.
  • Usage: Distributes chairs evenly along the edges of a table based on the table's dimensions.

orient-chairs-to-table

  • Function: A post-processing tool that automatically rotates chairs to face the center or edge of their parent table.
  • Usage: Ensures that after a bulk placement, all chairs are facing the correct, logical direction.

extend-wide-side-chairs

  • Function: Fills the long edge of a conference table with the maximum ergonomic number of chairs.
  • Usage: "Fill the sides of the boardroom table with executive chairs."

structured-meeting-corner

  • Function: An advanced macro tool that generates a complete meeting setup (table, chairs, screen, lighting) in a specified corner of the room envelope.
  • Usage: Instantly populates a functional zone without requiring step-by-step instructions.

structured-room-and-furnish

  • Function: The ultimate macro capability. It drafts the room and applies a comprehensive layout template in a single execution.
  • Usage: "Generate a standard small private office."

5. Viewport & Interaction

Tools for managing the user's view and selection state.

selection-move

  • Function: Translates or rotates the currently selected items in the 3D viewport.
  • Usage: "Move the desk 20cm to the left."

viewport-focus

  • Function: Drives the camera to frame specific coordinates or objects.
  • Usage: Automatically focuses the camera on newly inserted items or specific architectural zones (e.g., "Show me the kitchen area").

6. System & Verification

Internal tools used by the agent to maintain state and safety.

scene-read-pending & scene-read-bypass

  • Function: Reads the current state of the scene graph to verify placements or detect collisions.
  • Usage: The agent uses this internally to ensure a table isn't clipping through a wall before rendering it.

clear-scene

  • Function: Wipes the entire scene graph.
  • Usage: Requires explicit user confirmation via the UI due to its destructive nature.