# Photo Exhibit Wall Layout AI Agent Connect

> Photo Exhibit Wall Layout MCP handles the geometry of gallery installations. It calculates exact coordinates for frames, checks for overlaps, and determines how much wall space you're actually using. Instead of guessing where a print should hang, you give your AI client the wall dimensions and frame sizes, and it handles the spatial math.

## Overview
- **Category:** design-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_0l9WOhpzntUPmjWDynxZLGNMdD6nRxe1rF6trgVU/ai-agent-connect
- **Tags:** layout, photography, spatial, exhibit, geometry

## Description

Setting up a photo exhibit shouldn't feel like a guessing game. This MCP takes the headache out of spatial planning by treating your wall like a coordinate plane. You can provide your agent with specific wall dimensions, frame sizes, and required safety margins, and it will generate a mathematically sound layout. It prevents the common mistakes of overlapping frames or crowding a wall too tightly. If you need to maximize the gap between prints to give each piece breathing room, the math is done for you. It also helps you see if a collection is too small for a large wall or if you've overstuffed a space. Whether you are prepping a solo gallery show or just hanging a series of prints in a studio, this tool ensures every piece sits exactly where it belongs according to your constraints.

## Tools

### calculate_layout
This tool generates a set of valid coordinates for your frames based on your specific wall constraints.

### find_optimal_spacing
Use this to find the largest possible uniform gap you can maintain between frames in a specific pattern.

### get_wall_utilization
This tool measures how much of the wall surface is covered to see if the arrangement is too dense or too sparse.

### validate_placement
This tool checks your proposed coordinates to ensure frames don't overlap or break your margin rules.

## Prompt Examples

**Prompt:** 
```
I have a wall that is 200cm wide and 150cm high. I want to place three frames, each 40x40cm, with a 10cm safety margin and 15cm spacing between them. Where should I put them?
```

**Response:** 
```
The frames can be placed at the following coordinates: Frame 0 at (10, 10), Frame 1 at (65, 10), and Frame 2 at (120, 10).
```

**Prompt:** 
```
What is the maximum spacing I can have between 4 frames (50x50cm) on a 300x200cm wall with a 20cm safety margin?
```

**Response:** 
```
The maximum possible uniform inter-frame spacing for this configuration is 45.5cm.
```

**Prompt:** 
```
Is this layout valid? Wall: 100x100, Margin: 5, Spacing: 5. Frame 1: (10,10) size 20x20. Frame 2: (15,15) size 20x20.
```

**Response:** 
```
No, the layout is invalid because Frame 1 overlaps Frame 2.
```

## Capabilities

### Coordinate Generation
Your agent calculates the exact X and Y positions for every frame in your collection.

### Collision Detection
The tool identifies if any frames are overlapping or violating your set margins.

### Spacing Optimization
It finds the largest possible uniform gap between items to prevent a cluttered look.

### Density Analysis
The AI checks if your arrangement leaves too much empty space or feels overcrowded.

## Use Cases

### Gallery Exhibition Planning
Map out a series of prints on a large gallery wall before any nails are driven into it.

### Studio Wall Organization
Determine the best way to hang a new collection in a limited workspace.

### Client Mockups
Provide precise placement data to clients to show how their art will look in a room.

### Space Utilization Checks
Verify if a set of frames is too small for a massive wall before committing to a layout.

## Benefits

- Eliminates manual math for frame positioning.
- Prevents physical installation errors like overlapping frames.
- Ensures consistent spacing across all pieces.
- Provides instant verification of spatial constraints.

## How It Works

Connect your client to Vinkius and start sending dimensions to your agent.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Provide your wall dimensions and frame sizes to your agent.
3. Define your required margins and spacing rules.
4. The agent uses the MCP tools to calculate or validate the layout.
5. Receive exact coordinates for your installation.

## Frequently Asked Questions

**How do I use this MCP with Claude?**
You connect your Claude client to Vinkius once. After that, you can simply ask Claude to calculate layouts or check frame placements using the tools provided by this MCP.

**Can it prevent frames from overlapping?**
Yes. The validate_placement tool specifically checks if your coordinates result in frames that overlap or violate your safety margins.

**Does it work with any wall size?**
It works with any wall dimensions you provide, as long as the frames can physically fit within those constraints.

**What kind of output does it provide?**
The MCP provides specific X and Y coordinates for each frame, as well as spacing measurements and density percentages.

**Do I need to install anything on my computer?**
No. Vinkius hosts the MCP. You only need to connect your client to the Vinkius platform to start using the tools.

**How do I find where to place my frames?**
You can use the `calculate_layout` tool to automatically determine a valid set of coordinates for your frames based on your wall dimensions and spacing constraints.

**Can I check if my manual layout is safe?**
Yes, the `validate_placement` tool checks if your proposed coordinates respect safety margins and prevent frames from overlapping.

**How much of my wall will be covered?**
The `get_wall_utilization` tool calculates the occupancy percentage and the remaining empty area of your wall.
