# Setback Calculator MCP

> The Setback Calculator MCP determines exactly how much area you can build on a lot by applying local zoning setback rules. It takes your raw property dimensions and calculates the true, usable building envelope—the maximum footprint allowed before you start breaking the law.

## Overview
- **Category:** real-estate
- **Price:** Free
- **Tags:** setback, building-footprint, land-use, zoning-code, construction

## Description

Zoning laws are strict. They dictate minimum distances from property lines that you have to maintain; ignore them and your build gets shut down. This MCP handles those rules instantly. You input your lot dimensions and the required setbacks, and it figures out the maximum usable space for construction.

It doesn't just give you a number; it runs through the whole process: first, figuring out the absolute max building envelope size. Then, using that data, it calculates the total buildable area and how efficiently your plot is actually used compared to the entire land parcel. When you run this on Vinkius, your agent logs every calculation step in the full audit trail. This means you always see exactly which setback rule was applied and why the final metrics look the way they do. It’s essential for any preliminary zoning review.

## Tools

### calculate_building_footprint
Calculates the total buildable area and perimeter using usable envelope measurements.

### calculate_land_utilization_metrics
Compares your planned buildable footprint area against the total land area to find the usage percentage.

### calculate_usable_dimensions
Determines the maximum legal building size by applying all required setbacks to a property's lot dimensions.

## Prompt Examples

**Prompt:** 
```
I have a lot that is 40m long and 25m wide. My local code requires a 5m front setback, 3m rear setback, and 4m side setbacks on both sides. What are my buildable dimensions?
```

**Response:** 
```
To find this, I will execute the `calculate_usable_dimensions` tool with lotLengthMeters=40, lotWidthMeters=25, frontSetbackMeters=5, rearSetbackMeters=3, sideA_setbackMeters=4, and sideB_setbackMeters=4. The result will give me the maximum usable length and width.
```

**Prompt:** 
```
Using my restricted dimensions of 32m by 17m, what is the total buildable area and perimeter?
```

**Response:** 
```
I will run `calculate_building_footprint` with usableLengthMeters=32 and usableWidthMeters=17. This provides the total footprint area in square meters, which is essential for zoning submissions.
```

**Prompt:** 
```
If my lot's total area is 800 sq.m., and the building footprint is 512 sq.m., what percentage of land can I actually use?
```

**Response:** 
```
I will call `calculate_land_utilization_metrics` using totalLandAreaSqMeters=800 and buildingFootprintAreaSqMeters=512. This calculation gives the utilization percentage, confirming compliance.
```

## Capabilities

### undefined
undefined

### undefined
undefined

### undefined
undefined

## Use Cases

### The site has complicated setbacks.
A developer inputs their lot measurements and all local rules (e.g., 5m front, 3m rear). The agent runs `calculate_usable_dimensions` and returns the absolute maximum buildable size immediately.

### I need to know if my design is efficient.
An architect has a proposed footprint (e.g., 512 sq.m.) and knows the total lot area (800 sq.m.). The agent runs `calculate_land_utilization_metrics` to confirm compliance percentage.

### I've finalized my usable space, now what?
The engineer has the maximum dimensions (e.g., 32m by 17m). The agent runs `calculate_building_footprint` to provide both the total area and the required perimeter for zoning submission.

## Benefits

- Stop guessing about zoning. `calculate_usable_dimensions` gives you the precise, legally restricted dimensions for any lot based on required setbacks.
- Quickly assess efficiency with `calculate_land_utilization_metrics`. You get a clear percentage showing how much of your land is actually dedicated to structure versus open space.
- `calculate_building_footprint` delivers the total square footage and perimeter you can use, which is crucial for submitting accurate zoning plans.
- The MCP handles complex dimensional math—you don't need CAD software just to check preliminary compliance. It keeps the calculations clean and traceable.
- Because every step runs on Vinkius, your agent provides a full audit trail of how the usable dimensions were derived from your initial lot size.

## How It Works

The bottom line is you get a clear report of your lot's actual limits, so you know exactly what you can submit for approval.

1. Start by providing your raw lot measurements along with all local setback requirements (front, rear, and side).
2. The MCP runs those setbacks through its calculation engine to determine the maximum legal building envelope dimensions.
3. Finally, it uses those usable dimensions to calculate the final buildable footprint and how efficiently that area covers the total land.

## Frequently Asked Questions

**How does calculate_usable_dimensions work?**
It takes your raw lot measurements and applies every required setback—front, rear, sides—to give you the maximum legal dimensions for construction. This is always the first step.

**Can I use calculate_building_footprint with my usable dimensions?**
Yes. Once you have the usable envelope from `calculate_usable_dimensions`, you feed those numbers into this tool to get the total buildable area and perimeter.

**Is calculating land utilization metrics the same as footprint?**
No, they are different. The footprint is the physical size of the building; utilization measures what percentage of the whole lot that building covers relative to the total plot area.

**What if my property has unusual corner setbacks?**
The tool processes multiple side and front/rear constraints simultaneously, ensuring all specified setback rules are accounted for when finding usable space.

**What happens if I provide invalid measurements to calculate_usable_dimensions?**
The tool immediately stops and returns a specific error message. It won't just fail; it will pinpoint exactly which setback value is too large or conflicts with your lot dimensions, helping you correct the inputs.

**Can I chain calculate_usable_dimensions output into calculate_building_footprint?**
Yes. You can pass the maximum usable length and width returned by one tool directly into the input parameters of another. This lets your agent build an automated, multi-step calculation workflow.

**Does calculate_land_utilization_metrics handle unit conversions if my measurements aren't in square meters?**
No, you must ensure all inputs are consistently measured in square meters. If your source data is in a different unit (like feet or acres), convert it first before running the utilization metrics calculation.

**Are there rate limits when using calculate_building_footprint repeatedly?**
The Vinkius platform handles the underlying infrastructure, so basic usage is highly stable. If you are running extremely high-volume requests in a very short time, check your specific plan details for any defined throughput caps.

**What is the first step in calculating buildable dimensions?**
You must first use the `calculate_usable_dimensions` tool. This function takes your total lot size and mandatory setbacks (front, rear, side A, side B) to determine the absolute maximum buildable length and width.

**How do I find the total area of my potential building?**
Once you have the usable dimensions, pass them to the `calculate_building_footprint` tool. This calculates the maximum rectangular area (the footprint) and its perimeter based on those restricted measurements.

**Does this calculator tell me if my lot size is efficient?**
Yes. By using the `calculate_land_utilization_metrics` tool, you compare your calculated building footprint area against the total land area. This gives you a utilization percentage (0-100%), helping you assess zoning compliance risk.