# aWATTar MCP

> aWATTar gives you real-time electricity market data and specialized YAML statistics for smart home automation. Use this MCP to pull EPEX Spot prices directly into your workflow, letting your agent know the current cost of power or future price trends. You can schedule high-energy tasks to run automatically during the cheapest hours.

## Overview
- **Category:** iot-hardware
- **Price:** Free
- **Tags:** electricity-prices, smart-home, energy-management, epex-spot, automation

## Description

aWATTar lets you monitor electricity costs and optimize how you use energy at home. This MCP provides direct access to EPEX Spot market prices, giving you actionable data for your smart systems. Instead of checking multiple websites or logging into separate dashboards, your AI client pulls the necessary price information right when you need it. You can get current pricing statistics in YAML format, which is perfect for feeding automation logic like Loxone. Need to plan ahead? The system also fetches market data that includes prices for the next day, so you can schedule big appliance runs for the lowest cost window. It’s all about having clean energy numbers—from real-time checks to tomorrow's forecast—available instantly through your AI client. Since Vinkius hosts this MCP, connecting it is simple; you just link your preferred agent and start querying data.

## Tools

### get_current_yaml
Retrieves current aWATTar price statistics in YAML format, optimized for home automation systems.

### get_market_data
Fetches comprehensive electricity market data (EPEX Spot prices), including updates for the next day.

## Prompt Examples

**Prompt:** 
```
Get the current electricity market data from aWATTar.
```

**Response:** 
```
I've retrieved the latest EPEX Spot prices. The current price is 12.4 cents/kWh, with a peak of 15.2 cents at 19:00 and a low of 8.1 cents at 03:00. Would you like to see the full hourly breakdown?
```

**Prompt:** 
```
Show me the YAML price statistics for Loxone, including tomorrow's data.
```

**Response:** 
```
I've generated the YAML configuration for your Loxone system. It includes the hourly thresholds for today and tomorrow. Tomorrow's average price is slightly lower at 10.8 cents/kWh. You can copy this YAML directly into your automation logic.
```

**Prompt:** 
```
What are the energy prices for the next 24 hours?
```

**Response:** 
```
Fetching market data for the next 24-hour window... I found that prices will drop significantly between 01:00 and 05:00 AM. This would be the best time to run high-energy appliances. Would you like the specific price for each hour?
```

## Capabilities

### Get current automation statistics
You can use the `get_current_yaml` tool to retrieve a snapshot of the latest electricity price statistics formatted in YAML, ready for smart home controllers.

### Retrieve future market pricing
The `get_market_data` tool fetches comprehensive market data, including prices updated for the next day, helping you plan energy usage weeks ahead.

## Use Cases

### Optimizing the HVAC Schedule
The Facility Manager needs to run their central air conditioning during the cheapest hours. They ask their agent to fetch market data using `get_market_data`, which shows a significant price drop between 01:00 and 05:00 AM, allowing them to adjust their HVAC schedule for maximum savings.

### Configuring Smart Lighting
A smart home enthusiast wants their lighting system to dim based on real-time cost. They use `get_current_yaml` to feed the latest price thresholds into Loxone, letting the lights automatically respond to immediate energy costs.

### Comparing Consumption Costs
An energy consultant needs to show a client how much they could save. They use `get_market_data` to pull data for specific time intervals across different months, providing precise cost reports based on EPEX Spot pricing.

### Setting up Automated Alerts
The user wants an alert when power costs spike above a certain threshold. They use the current price statistics from `get_current_yaml` and program their agent to monitor for peak values, sending immediate notifications.

## Benefits

- Save money by scheduling high-consumption tasks. By using `get_market_data`, you can see tomorrow's prices and ensure demanding appliances run only when the cost is lowest.
- Integrate easily with existing smart systems. The `get_current_yaml` tool delivers price statistics in YAML, ready to be consumed by controllers like Loxone or Home Assistant without manual parsing.
- Understand market trends instantly. You don't have to jump between multiple energy websites; your agent pulls real-time EPEX Spot data directly into your chat for immediate analysis.
- Plan ahead with future pricing. The `get_market_data` tool updates daily, giving you a forecast of next day's prices so you can optimize weeks in advance.
- Build powerful energy apps. IoT developers get clean, structured market data using epoch timestamps, making it simple to build sophisticated, cost-aware applications.

## How It Works

The bottom line is that you get clean, formatted energy price data delivered directly into your conversational workflow.

1. Subscribe to this MCP and connect your credentials through Vinkius.
2. Ask your AI client to fetch market data or current YAML stats using the appropriate tool name.
3. Your agent processes the request and returns structured pricing data, which you can then use in your smart home logic.

## Frequently Asked Questions

**How often does the aWATTar MCP update market prices?**
The system updates daily at 14:00 CET/CEST. This ensures you have the most current forecast for the next day's electricity pricing.

**Does get_market_data only show today’s prices?**
No, `get_market_data` fetches market data that includes price forecasts for the next day. This lets you plan energy usage well ahead of time.

**What is the difference between get_current_yaml and get_market_data?**
`get_current_yaml` provides an immediate snapshot of current pricing in a specific YAML format for automation. `get_market_data` gives you the broader market context, including future price trends.

**Can I use this MCP for historical energy data?**
This MCP focuses on real-time and near-future pricing (EPEX Spot). For deep historical reporting over many years, you might need a dedicated database tool.

**Is the YAML format from get_current_yaml compatible with Loxone?**
Yes. The data is specifically formatted for smart home controllers like Loxone and other automation systems to consume easily.