kukios-mcp 1.0.0

MCP server for KukiOS IAQ Monitoring Platform

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

pip install kukios-mcp

Or from source:

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

Configuration

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

Quick Start

# 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 for:

• Claude Desktop configuration
• Cursor IDE setup
• HTTP mode for web apps

License

MIT License - See LICENSE

Contact

What If Labs - [e-mail]