# Excavation Volume Calculator AI Agent Connect

> Calculate precise earthwork volumes, including cut, loose, and backfill requirements.

## Overview
- **Category:** construction
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_wHL7X96LocDZOdcHpDVR0VH7KlSmc2u79xkdjSDX/ai-agent-connect
- **Tags:** earthwork, excavation, volume, soil, civil-engineering

## Description

This MCP server provides professional engineering tools for earthwork calculations. It allows AI agents to determine the exact volume of soil to be removed using `get_cut_volume`, calculate the expanded volume for transport with `get_loose_volume`, and determine necessary soil amounts for filling voids via `get_backfill_requirement`. It also includes `get_soil_properties_lookup` to retrieve standard swell, compaction, and shrinkage factors for various soil types like sand, clay, or gravel.

## Tools

### get_backfill_requirement
Calculates the volume of soil needed to fill a specific space, accounting for how the soil will compress

### get_cut_volume
Calculates the primary volume of soil to be removed from the ground based on excavation geometry

### get_loose_volume
Determines the volume the soil will occupy during transport and stockpiling

### get_soil_properties_lookup
Provides standard physical constants for different soil types to be used in volume calculations

## Prompt Examples

**Prompt:** 
```
Calculate the cut volume for an excavation 10m long, 5m wide, 3m deep, with a 45 degree slope angle.
```

**Response:** 
```
The total cut volume for the excavation is 210.0 m³.
```

**Prompt:** 
```
If I have 100 m³ of bank volume and the swell factor for sand is 1.2, what is the loose volume?
```

**Response:** 
```
The loose volume for 100 m³ of sand with a 1.2 swell factor is 120.0 m³.
```

**Prompt:** 
```
How much bank volume is needed to fill a 50 m³ void if the compaction factor is 0.9?
```

**Response:** 
```
To fill a 50 m³ void with a compaction factor of 0.9, you will need 55.56 m³ of bank volume.
```

## Frequently Asked Questions

**How does the tool account for soil expansion?**
The tool uses the `get_loose_volume` function which applies a swell factor to the bank volume to determine the total space the soil will occupy once excavated.

**Can I get specific soil constants?**
Yes, you can use `get_soil_properties_lookup` to retrieve standard swell, compaction, and shrinkage factors for common soil types.

**What is the difference between bank and loose volume?**
Bank volume is the soil in its natural state, while loose volume is the expanded volume after excavation, calculated using the swell factor.
