Metadata-Version: 2.4
Name: kukios-mcp
Version: 1.0.0
Summary: MCP server for KukiOS IAQ Monitoring Platform
Project-URL: Homepage, https://github.com/what-if-labs/kukios-mcp-server
Project-URL: Documentation, https://github.com/what-if-labs/kukios-mcp-server#readme
Project-URL: Repository, https://github.com/what-if-labs/kukios-mcp-server
Project-URL: Issues, https://github.com/what-if-labs/kukios-mcp-server/issues
Author-email: What If Labs <kuki@what-if.sg>
License-Expression: MIT
License-File: LICENSE
Keywords: air-quality,iaq,mcp,monitoring,sensor
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Requires-Dist: requests>=2.28.0
Description-Content-Type: text/markdown

# KukiOS MCP Server

MCP (Model Context Protocol) server for KukiOS IAQ Monitoring Platform.

## Overview

Connects AI assistants (Claude, Cursor, etc.) to KukiOS air quality monitoring platform via the MCP protocol.

**Platform URL:** https://dashbeta.what-if.sg

## Installation

```bash
pip install kukios-mcp
```

Or from source:
```bash
git clone https://github.com/what-if-labs/kukios-mcp-server.git
cd kukios-mcp-server
pip install -r requirements.txt
```

## Configuration

```bash
export IAQ_REPORTER_URL="https://dashbeta.what-if.sg"
```

## Quick Start

```bash
# Login
mcporter call kukios auth_login email="your-email" password="your-password"

# Get devices
mcporter call kukios list_devices

# Get readings
mcporter call kukios get_latest_readings device_id="device-uuid"
```

## Available Tools

**Authentication:**
- `auth_login` - Authenticate and get token
- `get_current_user` - Get user profile

**Buildings & Devices:**
- `list_buildings` - List buildings
- `get_building` - Get building details
- `list_devices` - List devices
- `get_device` - Get device details

**Sensor Readings:**
- `get_latest_readings` - Get latest sensor data
- `get_historical_readings` - Get historical data
- `batch_get_latest_readings` - Batch readings fetch

**Alerts:**
- `list_alerts` - List IAQ alerts
- `acknowledge_alert` - Acknowledge alert
- `resolve_alert` - Resolve alert

**Compliance:**
- `list_standards` - List compliance standards
- `calculate_compliance` - Calculate compliance grade

**IAQ Analysis:**
- `analyze_iaq_quality` - Analyze air quality
- `get_iaq_health_score` - Get health score (0-100)
- `compare_to_standards` - Compare to standards

**System:**
- `health_check` - Server health status
- `cache_stats` - Cache statistics
- `cache_clear` - Clear caches

## Setup Guides

See [SETUP.md](SETUP.md) for:
- Claude Desktop configuration
- Cursor IDE setup
- HTTP mode for web apps

## License

MIT License - See [LICENSE](LICENSE)

## Contact

What If Labs - kuki@what-if.sg