# Masonry Quantity Calculator MCP

> The Masonry Quantity Calculator gives you accurate material counts for any wall build. It calculates the exact number of blocks needed, the precise volume of mortar required, and converts that total into specific amounts of cement and sand. Stop guessing your order quantities; get reliable estimates for walls.

## Overview
- **Category:** construction
- **Price:** Free
- **Tags:** masonry, construction-tools, material-calculator, building-materials, quantity-surveying

## Description

Need to figure out how much stuff a new wall requires? This MCP handles all the math. You feed it the dimensions—the size of your blocks, the area of the wall, and the mix ratios for mortar. It first determines the total number of masonry units you need, factoring in waste margins. Next, it calculates both the bedding volume and any coating volumes for the mortar. Finally, it takes that combined mortar volume and tells you exactly how many bags of cement and cubic meters of sand to order. You just connect this MCP through Vinkius and let your agent run the numbers. This saves you time on site and keeps your budget right.

## Tools

### calculate_block_count
Determines the number of masonry units required for a given wall area.

### estimate_raw_materials
Calculates the specific quantities of cement and sand needed from a total mortar volume.

### calculate_mortar_volume
Provides the combined required cubic volume for both bedding joints and surface coatings.

## Prompt Examples

**Prompt:** 
```
How many 9x19x39 hollow blocks do I need for a 50 square meter wall, including 5% waste?
```

**Response:** 
```
For a 50 square meter wall using hollow_9x19x039 blocks with a 5% waste factor, you will need 657 blocks in total (626 base units plus 31 extra for waste).
```

**Prompt:** 
```
Calculate the mortar volume needed for a 20 square meter wall using hollow_14x19x39 blocks with a 0.02m coating thickness.
```

**Response:** 
```
The total mortar volume required is 0.15 cubic meters, consisting of approximately 0.04 cubic meters for bedding and 0.08 cubic meters for the coating.
```

**Prompt:** 
```
If I have 2 cubic meters of mortar and a mix ratio of 1:4, how much cement and sand do I need?
```

**Response:** 
```
For 2 cubic meters of mortar with a 1:4 ratio, you will need approximately 0.53 cubic meters of cement and 2.12 cubic meters of sand.
```

## Capabilities

### Determine Block Count
Calculates the necessary number of masonry units based on wall area, block dimensions, and waste factor.

### Calculate Mortar Volume
Figures out the total cubic volume of mortar needed for both bedding joints and surface coatings.

### Estimate Raw Materials
Converts the calculated total mortar volume into specific, usable quantities of cement and sand using a defined mix ratio.

## Use Cases

### Estimating a large foundation wall
A foreman needs to estimate material for a 100-meter run of blockwork. He uses `calculate_block_count` first, then inputs the total volume into `calculate_mortar_volume`. Finally, he runs `estimate_raw_materials` to get an immediate purchase order list for cement and sand.

### Recalculating materials after a design change
An architect changes the wall height. Instead of redoing all the math in CAD, they ask their agent to run `calculate_block_count` with the new dimensions, which automatically updates the necessary mortar volume and raw material estimates.

### Verifying a contractor's estimate
A project manager gets a quote for materials. They feed the wall area into `calculate_block_count` themselves to verify the unit count, making sure the contractor didn't underestimate waste.

### Checking material needs for coating
The crew leader knows they need extra mortar just for finishing/coating. He uses `calculate_mortar_volume` to isolate that specific volume and then runs `estimate_raw_materials` to get the exact cement needed, separate from the main bedding joint materials.

## Benefits

- Stop guessing your order quantities. By using `calculate_block_count`, you get an accurate unit count that accounts for real-world waste margins.
- Avoid costly site delays caused by running out of materials. Calculating both bedding and coating volumes with `calculate_mortar_volume` ensures you cover all necessary mortar applications.
- Never over-order cement again. The MCP converts total usage into precise raw material amounts using `estimate_raw_materials`, keeping waste low and costs down.
- It chains calculations together for you. You don't have to calculate blocks, then mortar volume, and *then* figure out the mix ratios manually—it all flows through your agent.
- The math is done in plain language. Instead of reading complex spreadsheets, your AI client gives you a direct answer: 'You need X bags of cement.'

## How It Works

The bottom line is you get three connected calculations that move from unit count to mortar volume to raw material purchase list.

1. Provide the tool with the wall dimensions and block type to determine unit requirements.
2. Input those details alongside coating measurements to calculate both bedding and finishing mortar volumes.
3. Finally, give it a mix ratio (like 1:4) to convert the total mortar volume into cement and sand quantities.

## Frequently Asked Questions

**How does calculate_block_count handle waste?**
It includes configurable waste margins directly in the final count. This means you get an estimate that accounts for typical cutting errors and breakage on site, preventing unexpected shortages.

**Can I use the Masonry Quantity Calculator if I change the block type?**
Yes. You simply update the dimensions used as input parameters, and all three tools—block count, mortar volume, and raw material estimates—will recalculate using the new specifications.

**Does estimate_raw_materials need the total wall area?**
No. It requires the calculated total mortar volume from `calculate_mortar_volume`. This separation means you can verify the material needs without needing to re-input the original wall dimensions.

**What is the difference between bedding and coating in this MCP?**
Bedding calculates the mortar for the joint between blocks. Coating covers the finished surface, which requires a separate calculation using `calculate_mortar_volume` to ensure you don't miss any spots.

**What unit system does `calculate_mortar_volume` require for accurate measurements?**
The calculator strictly requires metric units. You must input all dimensions, including thickness and length, in meters (m). The resulting mortar volume will be provided accurately in cubic meters ($	ext{m}^3$).

**Does running `calculate_mortar_volume` automatically feed data into `estimate_raw_materials`?**
No, you have to manually transfer the total mortar volume output from the first tool. You must pass that exact $	ext{m}^3$ figure as a required input when using `estimate_raw_materials`.

**If I have a large, irregular wall area, can `calculate_block_count` still handle it?**
Yes. The tool accepts the total surface area in square meters ($	ext{m}^2$) as its main input variable. Provide the overall span and height, and the function calculates units for that entire plane.

**What does `calculate_block_count` exclude from its calculation?**
The block count only estimates standard wall surfaces. It will not account for structural elements like lintel openings, foundation blocks, or complex corners; you need to calculate those specialized areas separately.