HxTP MCP Server

The HxTP Model Context Protocol (MCP) Server is a standardized interface between AI assistants and your IoT infrastructure. It enables Large Language Models (LLMs) to directly interact with, manage, and audit your HxTP tenant.

:::info Public Release The HxTP MCP Server is now public. It is no longer a restricted demo and is supported for production administrative workflows. :::

Overview

The server is implemented using the fastmcp framework. It exposes the administrative capabilities of the Hestia Labs Cloud API to any MCP-compliant client.

Key Capabilities

• Discovery: Inventory management for devices, homes, rooms, and groups.
• Control: Execution of HxTP commands with native support for dry-run flows.
• Audit: Retrieval of command history and real-time device status.
• Provisioning: Programmatic device registration and revocation.

Quick Start

The server requires an Admin API Key for backend communication.

Variable	Description	Requirement
HXTP_API_KEY	Admin API key with admin role privileges	Required
HXTP_BACKEND_URL	HxTP backend API endpoint	Defaults to https://api.hestialabs.in/api/v1

Claude Desktop Integration

To enable Claude for Desktop to interface with your IoT mesh, update your claude_desktop_config.json:

{
  "mcpServers": {
    "hxtp": {
      "command": "bun",
      "args": [
        "run",
        "/path/to/hestialabs/mcp/server.py"
      ],
      "env": {
        "HXTP_API_KEY": "hx_admin_...",
        "HXTP_BACKEND_URL": "https://api.hestialabs.in/api/v1"
      }
    }
  }
}

Available Tools

The server exposes the following administrative tools:

Observability & Discovery

• list_devices: Inventory of all registered devices.
• get_device_state: Current telemetry and property values.
• get_device_capabilities: Action manifest for a specific device.
• get_command_history: Historical execution log.

Command Dispatch

• execute_hxtp_command: Trigger actions on devices, rooms, or groups.
• confirm_hxtp_command: Handle dry-run confirmations for critical safety-gated actions.

Provisioning

• provision_device: Add a new device to your mesh.
• rotate_credentials: Trigger a cryptographic secret rotation.
• decommission_device: Permanently revoke a device's access.

---

:::warning Safety Advisory When using automated systems to control physical devices, we recommend always enabling the Safety Gateway in the HxTP backend. This ensures that critical actions (like firmware updates) require a second confirm call, providing a final verification layer for autonomous actions. :::