# Grain Direction Restrictor MCP for AI Agents AI Agent Connect > Grain Direction Restrictor enforces material grain orientation constraints for precise plywood cutting and bin packing. It ensures your AI client respects the physical limits of wood, preventing pieces from rotating into illegal positions during layout. This is essential for manufacturers who need to maintain structural integrity and minimize waste in complex cutting jobs. ## Overview - **Category:** optimization - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_zvZCScYQNLRIn9mi8beHHsmMmon9Y3wFb7DN6oe8/ai-agent-connect - **Tags:** plywood, cutting-optimization, bin-packing, grain-direction, manufacturing-constraints ## Description This plywood cutting constraint engine enforces physical constraints for wood and plywood processing. If you ignore the grain, the final product might warp, crack, or just look terrible. This Connector handles the heavy lifting of enforcing those rules. Instead of manually checking each piece to see if it's oriented correctly, you can let your agent handle the logic. It understands that a piece of wood has a "right way up" and will flag any layout that tries to flip it 90 degrees. It's a massive time-saver for anyone dealing with high-volume production where a single mistake can ruin an entire sheet of expensive stock. You can find this in the Vinkius catalog to quickly hook it up to your existing production workflow. It's built to stop the "oops" moments that happen when a bin-packing algorithm tries to be too clever with the layout and ignores the reality of the material. Most woodworkers face the headache of illegal rotations where a piece looks like it fits on a sheet but is actually oriented incorrectly for the final assembly. You end up spending your afternoon squinting at layouts and manually rotating pieces one by one to make sure they work. This tool removes that friction. It acts as a logic layer that validates your requirements against the physical properties of the wood. You get to focus on the big picture of production while the agent handles the tedious work of orientation checks. It ensures that your cut list is actually usable by the shop floor the first time you generate it. ## Tools ### get_oriented_dimensions This footprint calculator figures out the actual space a piece takes up based on its grain direction. It's the difference between a piece fitting on its side versus laying flat. ### validate_single_piece This validation tool checks one specific part against your stock sheet size. Use it to quickly confirm if a custom piece is viable before adding it to a batch. ### evaluate_batch_constraints This batch scanner finds the largest dimensions and identifies parts that won't fit. It helps you see the big picture of your cutting job before you start. ## Prompt Examples **Prompt:** ``` Check if a 50x100 piece with vertical grain fits in a 120x240 sheet. ``` **Response:** ``` Yes, the piece is compatible. The effective footprint for vertical orientation is 100x50, which fits within the 120x240 stock dimensions. ``` **Prompt:** ``` Calculate the effective width and length for a 30cm x 60cm piece with horizontal grain. ``` **Response:** ``` The effective width is 30cm and the effective length is 60cm. ``` **Prompt:** ``` Will a 250x150 piece with horizontal grain fit in a 240x120 sheet? ``` **Response:** ``` No, the piece exceeds the stock dimensions. The required width of 250cm is greater than the available stock width of 240cm. ``` ## Capabilities ### Check single piece fit Verifies if one specific part fits within your stock dimensions. ### Calculate oriented footprint Determines the actual space a piece occupies based on grain direction. ### Scan batch dimensions Identifies the maximum required dimensions for a whole list of parts. ### Flag illegal rotations Detects parts oriented incorrectly relative to the material grain. ### Verify structural integrity Ensures the layout respects the physical properties of the wood. ## Use Cases ### Checking a single part fit A furniture maker wants to know if a 50x100 piece with vertical grain fits in a 120x240 sheet using `validate_single_piece`. ### Validating a large batch A CNC shop needs to validate a batch of 50 different parts to find the maximum dimensions required using `evaluate_batch_constraints`. ### Calculating shelf footprint A cabinet maker wants to calculate the footprint of a shelf that must have horizontal grain using `get_oriented_dimensions`. ### Catching rotation errors A production manager wants to catch errors where a piece is rotated 90 degrees the wrong way before it hits the saw. ## Benefits - Stop wasting expensive plywood by preventing illegal rotations. By using `validate_single_piece`, you ensure each part stays in its correct orientation before the first cut is made. - Get accurate footprint data for each part with `get_oriented_dimensions` to ensure perfect fits. This eliminates the guesswork of how a piece actually sits on the sheet. - Identify batch-wide errors instantly with `evaluate_batch_constraints` before sending jobs to the CNC. You can see the big picture of your project and catch issues early. - Maintain structural integrity of finished furniture by enforcing horizontal and vertical grain rules. This ensures your final products won't warp or fail under stress. - Reduce manual layout revisions by letting your agent handle the orientation logic automatically. This saves hours of back-and-forth between design and production. ## How It Works The bottom line is you get a production-ready cut list that won't cause material failure or waste. 1. Provide the dimensions of your stock material and the list of pieces you need to cut. 2. Define the required grain orientation for your parts. 3. Get a validated list of pieces that fit the stock while respecting all physical constraints. ## Frequently Asked Questions **Does the Grain Direction Restrictor work for all types of wood?** Yes, it works for any material where grain orientation matters, like plywood, solid wood, or even certain composites. **How does it prevent waste in my cutting layout?** It ensures that each piece is oriented correctly relative to the stock sheet. This prevents the AI from cheating by rotating pieces into positions that would cause structural failure. **Can I use it to check a whole batch of parts at once?** Yes, you can use it to scan a full list of parts to find the maximum dimensions and identify any that do not fit the stock. **What is the difference between a footprint and a dimension?** A dimension is just the size of the piece. The footprint is the actual space it occupies based on how the grain is oriented, which might change depending on whether it is horizontal or vertical. **Can this help me with bin packing algorithms?** Exactly. It provides the necessary constraints to make bin-packing grain-aware, so your algorithms do not produce illegal layouts. **Is this tool for CNC programming?** It is great for CNC workflows because it validates the layout before it ever hits the machine, saving you from costly material errors. **How does the tool handle vertical grain orientation?** When `grainDirection` is set to 'vertical', the tool swaps the piece's width and length mapping. The intrinsic width is checked against the stock length, and the intrinsic length is checked against the stock width. **Can I use this for standard bin packing without grain constraints?** While you can set all pieces to a single orientation, this tool is specifically built to enforce the restriction that prevents rotation. If you need free rotation, you would typically use a different optimization engine. **What happens if a piece exceeds the stock dimensions?** The `validate_single_piece` tool will return a failure status with an error message indicating whether the oriented width or length exceeded the available stock limits.