# Solar Self-Consumption Calculator AI Agent Connect

> Solar Self-Consumption Calculator lets your AI client run precise simulations for residential solar and battery storage systems. It handles the math for hourly energy movements, battery state projections, and the financial impact of solar generation versus household load.

## Overview
- **Category:** mathematics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_vcJJhji3WjRIyE0a6aFS3z01tJxhV97qWLZEIH1l/ai-agent-connect
- **Tags:** solar, battery, energy-flow, economics, simulation

## Description

You can use this MCP to build detailed models of how solar energy interacts with home loads and battery storage. Instead of manually calculating energy flows, you give your agent the generation and consumption data, and it handles the heavy lifting. It can track how much energy moves from panels to the battery, how much is used by the house, and how much is sent back to the grid. You can project how a battery will behave over several hours or days to see if a specific setup actually meets a household's needs. It also calculates the daily financial impact, showing you the net cost or credit based on imports and exports. This makes it easy to test different battery capacities or solar array sizes before any hardware is actually installed.

## Tools

### analyze_self_consumption_efficiency
This tool evaluates how effectively a solar system uses its own generated energy.

### calculate_daily_economics
This tool determines the total financial cost or savings for a single day based on energy flows.

### calculate_hourly_energy_flow
This tool calculates specific energy movements like consumption, storage, export, and import for a single hour.

### simulate_battery_cycling
This tool projects the state of a battery over a series of hourly energy flows.

## Prompt Examples

**Prompt:** 
```
Calculate the energy flow for an hour with 5000Wh generation, 2000Wh load, 1000Wh current battery charge, and 5000Wh capacity.
```

**Response:** 
```
In this hour, 2000Wh is consumed by the load, 3000Wh is used to charge the battery (bringing it to 4000Wh), and 0Wh is exported.
```

**Prompt:** 
```
What are the economics if I imported 1000Wh at 0.15/Wh and exported 500Wh at 0.08/Wh?
```

**Response:** 
```
The total import cost is 150.00, the total export credit is 40.00, resulting in a net cost of 110.00.
```

**Prompt:** 
```
How efficient is a system that produced 10000Wh, used 7000Wh, and exported 2000Wh?
```

**Response:** 
```
The self-consumption ratio is 0.7 and the wasted energy ratio is 0.2.
```

## Capabilities

### Hourly Energy Modeling
Your agent calculates the exact movement of energy between generation, load, and storage every hour.

### Battery State Projection
The AI simulates how battery charge levels change over time based on usage patterns.

### Financial Impact Analysis
Your agent calculates daily net costs or credits from energy imports and exports.

### Efficiency Evaluation
The AI determines how much solar energy is actually used by the home versus wasted or exported.

## Use Cases

### System Sizing
Test if a specific battery capacity can handle a household's nightly load.

### Economic Forecasting
Calculate the daily cost of importing energy versus the credit from exporting solar excess.

### Performance Auditing
Check how much solar energy is being wasted or exported to see if efficiency can be improved.

### Load Profiling
Model how different hourly consumption patterns affect battery state of charge.

## Benefits

- Calculates complex energy flows without manual math.
- Simulates battery behavior over time to prevent under-sizing.
- Provides clear daily financial totals for solar savings.
- Determines exact self-consumption ratios for any given setup.

## How It Works

Connect your AI client to Vinkius and start running energy simulations immediately.

1. Connect your preferred MCP-compatible client to Vinkius.
2. Provide your solar generation, load, and battery data to your agent.
3. Ask the agent to run specific calculations like hourly flows or battery simulations.
4. Receive detailed energy, battery, or economic results directly in your chat interface.

## Frequently Asked Questions

**What can this MCP calculate?**
It calculates hourly energy flows, battery state projections, daily economic costs or credits, and self-consumption efficiency.

**Which AI clients can use this MCP?**
You can use this MCP with any compatible client like Claude, Cursor, Windsurf, or VS Code.

**Do I need to host the MCP myself?**
No, Vinkius hosts and manages the MCP for you. You just connect your client and start using the tools.

**Can I model battery life?**
Yes, the simulate_battery_cycling tool allows you to project the state of a battery over a series of hourly flows.

**How does it handle solar economics?**
The calculate_daily_economics tool uses energy import and export data to find the net financial cost or savings for a day.

**How do I calculate my daily savings?**
Use the `calculate_daily_economics` tool by providing the total energy imported from the grid, total energy exported to the grid, and the respective import and export rates.

**Can I simulate battery usage over a full day?**
Yes, the `simulate_battery_cycling` tool allows you to project battery state by providing an array of hourly generation and load data.

**What determines if energy is exported to the grid?**
Energy is exported when solar generation exceeds both the household load and the current charging capacity of the battery.