# Thermal Mass Estimator MCP

> The Thermal Mass Estimator calculates how heat moves through building walls. It quantifies thermal lag, the degree of temperature fluctuation reduction (damping), and the U-value for various materials like brick or concrete. You use this MCP to run complex physics calculations needed for energy modeling and envelope performance testing.

## Overview
- **Category:** construction
- **Price:** Free
- **Tags:** thermal-mass, u-value, building-science, insulation, energy-efficiency

## Description

Building a structure requires more than just stacking bricks; you have to understand how heat moves through it over time. This MCP gives you specialized tools to quantify the thermal performance of any building envelope. Instead of running multiple spreadsheets and manually checking material constants, this connector pulls fundamental data—like conductivity and density—for materials such as concrete or brick. Then, it uses those inputs to calculate a wall's precise thermal transmittance (U-value). You can also project how much temperature swings are dampened and what the time delay is for heat moving through the entire structure. Accessing this kind of specialized simulation power is usually hard work, but with Vinkius hosting this MCP in your catalog, you get reliable results directly into your workflow.

## Tools

### calculate_u_value
Calculates the thermal transmittance (U-value) for a single layer of building material.

### estimate_thermal_behavior
Projects how much temperature fluctuations are reduced and what the time delay is across a wall layer.

### get_material_properties
Retrieves fundamental thermal properties like conductivity, density, and specific heat for any listed material.

## Prompt Examples

**Prompt:** 
```
What are the thermal properties of concrete?
```

**Response:** 
```
The `get_material_properties` tool shows that concrete has a specific conductivity, density, and specific heat capacity.
```

**Prompt:** 
```
Calculate the U-value for a 0.2m brick wall.
```

**Response:** 
```
Using `calculate_u_value` with thickness 0.2 and material 'brick', the tool returns the calculated thermal transmittance.
```

**Prompt:** 
```
Estimate the thermal behavior of a 0.1m wood layer.
```

**Response:** 
```
The `estimate_thermal_behavior` tool provides the estimated thermal lag in hours and the damping factor for this thickness.
```

## Capabilities

### Determine fundamental material inputs
Retrieve core thermal properties (conductivity, density, specific heat) for building materials.

### Calculate wall transmittance rates
Find the U-value, which measures how easily heat passes through a specific layer of material.

### Project thermal time effects
Estimate both the time lag and the amplitude damping factor for heat moving through a structure.

## Use Cases

### The client demands proof of low energy usage.
An architect needs to prove that using locally sourced brick reduces the building's total cooling load. They run `get_material_properties` on the brick, then use this MCP to calculate the U-value and estimate thermal behavior, presenting a clear data packet proving compliance.

### The site has wildly fluctuating outdoor temperatures.
A mechanical engineer needs to know how quickly the wall structure will react to sudden weather shifts. They run `estimate_thermal_behavior` on a layer of concrete, getting precise data on thermal lag and damping that informs their HVAC sizing.

### The initial material choice fails code compliance.
A building scientist discovers the current wall assembly exceeds local energy codes. They use `calculate_u_value` repeatedly with different thicknesses of insulation to find the minimum required change, saving weeks of manual calculation.

### You need a single source for all thermal data.
Instead of gathering conductivity from one database and U-values from another, you send your agent to this MCP. It pulls `get_material_properties` first, then uses the output to run both `calculate_u_value` and `estimate_thermal_behavior` sequentially.

## Benefits

- Determine if your proposed materials meet code. Use `calculate_u_value` to quickly check thermal transmittance for any layer thickness and material combination.
- Model real-world heat dynamics. Run `estimate_thermal_behavior` to see how temperature fluctuations are reduced (damping) and what the time delay is (lag).
- Avoid guesswork with inputs. Use `get_material_properties` to pull validated data points for conductivity, density, and specific heat capacity.
- Speed up your design cycle. Instead of cross-referencing multiple textbooks, you get core physics calculations instantly from your agent.
- Build better energy models. By linking the material properties with both U-value and thermal behavior, you create a complete picture of envelope performance.

## How It Works

The bottom line is, this lets you run full thermal simulations without leaving your agent environment.

1. First, run `get_material_properties` to pull the necessary thermal constants for your chosen building material.
2. Next, you feed those inputs into either `calculate_u_value` (for basic transmission) or `estimate_thermal_behavior` (for time-series analysis).
3. The MCP delivers the calculated performance metrics—like U-value and damping factor—allowing you to assess the structure's energy efficiency.

## Frequently Asked Questions

**How do I calculate U-value using the `calculate_u_value` tool?**
You provide the agent with the wall thickness and material type. The MCP runs the calculation, giving you the thermal transmittance value for that specific layer.

**What is the difference between U-value and `estimate_thermal_behavior`?**
U-value is a static measure of heat transfer rate; it's what the wall transmits right now. `estimate_thermal_behavior` projects how that performance changes over time—the lag and damping.

**Do I need to use `get_material_properties` before anything else?**
Yes, you should always start there. It ensures the MCP has the correct conductivity, density, and specific heat data for your material before it runs any calculations.

**`estimate_thermal_behavior` only works on wood?**
No. You use `get_material_properties` first to check if the MCP supports the thermal constants for whatever building material you're using, like concrete or brick.

**What units must I use when running `calculate_u_value` for wall thickness?**
It requires the thickness in meters. Always ensure your input measurements are standardized to SI units; otherwise, the resulting thermal transmittance will be inaccurate.

**If I try to call `get_material_properties` with a material not recognized by the system, what happens?**
The tool returns an explicit error message and suggests checking your spelling or consulting the approved list of building compounds. You'll get a specific code indicating invalid input.

**Can I use `calculate_u_value` to model complex, multi-material wall assemblies?**
No, it calculates U-values for single layers only. If your wall is made of several materials, you need to run the tool for each layer and average them manually.

**Is there a rate limit on how often I can use `estimate_thermal_behavior`?**
The MCP supports high-volume usage for most clients. If you hit a temporary limit, the system will prompt you to wait; usually, thirty seconds is enough before retrying.

**What materials are supported?**
The server currently supports brick, concrete, wood, and drywall.

**How is the U-value calculated?**
The U-value is calculated as the ratio of the material's thermal conductivity to its thickness in meters.

**What does thermal lag represent?**
Thermal lag represents the time interval between peak external temperature and peak internal temperature.