# Shading Device Calculator MCP for AI Agents AI Agent Connect

> Shading Device Calculator helps you calculate precise dimensions for horizontal and vertical solar shading devices. It handles solar geometry, louver depth, and fin width to ensure your architectural designs meet specific thermal comfort and solar cutoff goals.

## Overview
- **Category:** construction
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_wALeVmIQdhAk9igSQng0cKwy2I9Kn8RKrsgHCMuA/ai-agent-connect
- **Tags:** solar-geometry, shading, architecture, thermal-comfort, sun-position, engineering-tools

## Description

Imagine you're designing a high-rise building and need to ensure the balconies don't overheat the interior during the summer. Instead of pulling out complex geometry tables or performing manual calculations, you can just tell your AI what the building's orientation is and what kind of sun protection you're thinking about. This Connector does the heavy lifting by calculating the exact depth of horizontal louvers or the width of vertical fins based on real solar positions. It takes the guesswork out of shading. You can check if a design actually hits your target cutoff angle or if you need to adjust the geometry before the plans go to construction. Because Vinkius makes it easy to plug this into your existing AI workflow, you can move from a rough concept to verified architectural dimensions in a single conversation. It's about getting the math right the first time so you can focus on the aesthetics and the building's overall performance.

## Tools

### validate_compliance
Check if a specific shading device design meets your required solar cutoff angles or identifies failure margins. Use this to audit your plans before construction.

### calculate_vertical_width
Calculate the necessary width for vertical fins based on solar orientation and desired shading. This is perfect for designing side-facing facade protection.

### calculate_horizontal_depth
Determine the minimum projection depth needed for horizontal louvers to hit a target cutoff angle. Use this to get accurate louver specs for south-facing windows.

### get_solar_position
Get the specific altitude and azimuth of the sun for any given time and location. This helps you understand the sun's path for different seasons.

## Prompt Examples

**Prompt:** 
```
What's the sun's position for a building in Los Angeles on June 21st at 2 PM?
```

**Response:** 
```
For **Los Angeles** on **June 21st at 2:00 PM**, the solar position is as follows:

| Metric | Value |
| :--- | :--- |
| **Altitude** | 58.4° |
| **Azimuth** | 245.2° |

This indicates a high sun angle from the southwest, which is typical for a summer afternoon.
```

**Prompt:** 
```
Calculate the louver depth for a south-facing window at latitude 40 with a 60-degree cutoff.
```

**Response:** 
```
Based on a **60-degree cutoff angle** for a **south-facing** orientation at **latitude 40**, here is the requirement:

*   **Required Horizontal Depth:** 0.82 meters

You'll need to ensure the louvers have at least this projection to meet your shading goal.
```

**Prompt:** 
```
Will a 0.6m deep louver meet a 45-degree cutoff at latitude 34?
```

**Response:** 
```
I've checked that design for you:

*   **Status:** ❌ **Non-Compliant**
*   **Target Cutoff:** 45°
*   **Actual Performance:** 38.5°
*   **Margin:** -6.5°

To meet your 45-degree goal at this latitude, you need to increase the depth to approximately **0.74 meters**.
```

## Capabilities

### Determine sun altitude and azimuth
Get the exact position of the sun for any location and time to inform your design.

### Calculate horizontal louver depth
Find the minimum projection needed for horizontal shading based on your target angle.

### Calculate vertical fin width
Get the required width for vertical shading elements based on solar orientation.

### Check design compliance
Audit your shading dimensions to see if they meet specific solar cutoff requirements.

### Audit existing structures
Verify if current building designs hit your thermal comfort goals.

## Use Cases

### Verifying louver depth for summer sun
An architect wants to know if a 0.5m louver will block enough sun in July. They ask the agent to use validate_compliance to check the 45-degree cutoff.

### Calculating requirements for a west-facing facade
A building faces West and needs specific louver depth. The user provides the orientation and asks for the depth using calculate_horizontal_depth.

### Finding solar position for site analysis
A designer needs to know the sun's position for a site in Dubai. They use get_solar_position to get the exact altitude and azimuth for the design kickoff.

### Sizing vertical fins for narrow buildings
A designer is working on a narrow facade. They use calculate_vertical_width to get the minimum width needed for the specific latitude.

## Benefits

- Get accurate solar geometry instantly with get_solar_position, removing the need to look up complex solar tables manually.
- Save hours of drafting by using calculate_horizontal_depth to get the exact louver projections required for your project.
- Ensure facade designs meet thermal goals using calculate_vertical_width to find the correct fin dimensions for any orientation.
- Avoid costly construction errors by using validate_compliance to double-check that your shading designs meet the required cutoff angles.
- Speed up the design review process by letting your agent audit existing structures for solar performance across different seasons.

## How It Works

The bottom line is you get accurate solar geometry and shading dimensions without doing the manual math.

1. Provide the location, date, and time to find the current sun position.
2. Input your design requirements like desired cutoff angles and louver types.
3. Get the precise measurements needed for your construction plans.

## Frequently Asked Questions

**Can the Shading Device Calculator help with my balcony design?**
Yes, it helps you find the exact louver depth and fin width needed to block specific sun angles while maintaining your desired aesthetic.

**Does the Shading Device Calculator work for both horizontal and vertical fins?**
Yes, it includes specialized tools for both horizontal louver depth and vertical fin width calculations.

**How do I use the Shading Device Calculator to check if my design is correct?**
You can use the compliance tool to input your current design dimensions and see if they meet your target solar cutoff angles.

**Can I use the Shading Device Calculator for different cities?**
Yes, it works for any location by using coordinates to determine the specific solar position for that area.

**Is the Shading Device Calculator for residential or commercial use?**
It's designed for both. Whether you're shading a private balcony or a commercial glass facade, the geometry math remains the same.

**Can the Shading Device Calculator give me the sun's path for a specific date?**
Yes, it can provide the specific altitude and azimuth for any date and time, which is helpful for seasonal planning.

**What does the calculator determine?**
It calculates the minimum depth for horizontal louvers and the maximum width for vertical fins needed to block sunlight based on solar trigonometry.

**How do I use the compliance tool?**
Use `validate_compliance` by providing your current device dimensions, solar position, and target cutoff angle to check if the shading is effective.

**What inputs are required for solar position?**
You need the latitude of the site, the day of the year, and the time of day in HH:mm format.