Developer Docs — meshams MCP Server | Connect any AI agent
Developers

Control your home from any AI agent.

The meshams MCP server lets Cursor, Claude Desktop, or any Model-Context-Protocol client read and control your Lumos switches, Aura sensors and Isaac purifier — over a single secure endpoint. 19 tools, scoped API keys, device-confirmed actions.

~/.cursor/mcp.json
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "meshams": {
      "url": "https://mcp.meshams.com/sse?api_key=YOUR_API_KEY"
    }
  }
}
Connect

Choose how you connect

Add the server to your Cursor config. The API key goes in the URL (Cursor does not send auth headers), then restart Cursor.

~/.cursor/mcp.json
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "meshams": {
      "url": "https://mcp.meshams.com/sse?api_key=YOUR_API_KEY"
    }
  }
}
The path

From idea to production

01

Get an API key

Create a key from your meshams owner dashboard, or POST /api/mcp/keys with your account token. Choose the scopes it needs — the key is shown once, so save it.

02

Configure your client

Drop the connection snippet into Cursor, Claude Desktop, or your own MCP client. The endpoint is https://mcp.meshams.com/sse.

03

List the tools

Call tools/list to discover every tool and its schema. initialize works without auth; tools/list and tools/call need your key.

04

Call tools

Invoke a tool by name with its arguments. Use list_rooms and list_devices first to discover the room and device IDs to act on.

05

Operate safely

Scopes gate access (devices:read, devices:control, rooms:read). Requests are rate-limited per key, and every control call returns a device-confirmed acknowledgement.

Reference

The tools

19 tools, grouped by what they touch. Call tools/list for the live schemas.

Devices

  • list_devices
    List all your devices, optionally filtered by room or type.
  • get_device_status
    Get the current status of a specific device.
  • turn_on_light
    Turn on a specific light/switch on a Lumos panel.
  • turn_off_light
    Turn off a specific light/switch on a Lumos panel.
  • batch_control
    Turn several devices on or off in a single call.

Rooms

  • list_rooms
    List all rooms with device counts — discover room IDs.
  • get_room_status
    Get the status of every device in a room.
  • turn_on_room
    Turn on all devices in a room.
  • turn_off_room
    Turn off all devices in a room.

Fan

  • set_fan_speed
    Set a fan gang’s speed (0–3).

Home & air quality

  • get_home_status
    Get an overview of all rooms and devices.
  • get_air_quality
    Aura sensor readings: AQI, PM2.5/PM10/PM1, temperature, humidity, VOC.

Isaac air purifier

  • get_isaac_status
    Isaac status: operating mode, battery, charging, on-board AQI.

Automations

  • list_automations
    List your sensor-triggered automations.
  • create_automation
    When a sensor crosses a threshold, act on a device.
  • toggle_automation
    Enable or disable an automation.

Reminders

  • list_reminders
    List scheduled one-off device actions.
  • create_reminder
    Schedule a one-off device action for a future time.
  • cancel_reminder
    Cancel a scheduled reminder.
Permissions

Scopes

  • devices:read
    Read device and sensor status.
  • devices:control
    Turn devices on/off, set fan speed, run automations.
  • rooms:read
    Read rooms and their device membership.
Resources

Keep going

Endpoint: https://mcp.meshams.com/sse · JSON-RPC 2.0 · auth via ?api_key= or Authorization: Bearer.