FeyaGate Skill — MCP Smart Home Gateway#

Control smart home devices (lights, cameras, AC, speakers) from any AI agent via MCP protocol. Supports Xiaomi · Tuya · Midea · eWeLink · Serial · GPIO.

Prerequisites#

• Python 3.9+
• macOS / Linux / Windows
• curl (for installation)

Before Using Any Tool#

Run this check before calling any FeyaGate MCP tool:

bash

feyagate status

• RUNNING → proceed with tool calls
• STOPPED or command not found → run feyagate start first
• Not installed → pip install feyagate-skill && feyagate setup && feyagate start

Quick Start#

bash

pip install feyagate-skill       # Install Python package
feyagate setup                   # Download MCP server binary (~30MB)
feyagate start                   # Start service on localhost:38080
feyagate install-claude          # Register with your AI agent
feyagate auth                    # Authorize smart home platform

Other agents: install-cursor, install-openclaw, install-hermes, install-codex, install-windsurf, install-copilot

Full guide: QUICKSTART.md

Server Lifecycle#

ActionCommandInstall binaryfeyagate setup [--dir PATH]Startfeyagate start [--port PORT]Stopfeyagate stopRestartfeyagate restart [--port PORT]Statusfeyagate statusLogsfeyagate log [-n 50]Updatefeyagate updateAuthfeyagate auth [--status] [--code CODE]

Cross-Platform Tools#

These tools work across all platforms (system auto-detects device platform):

ToolArgumentsReturnsdevice/list``filter (string[]), platform (opt)Devices with platform fielddevice/specs``deviceId (string)Platform-specific spec: properties, actionsplatform/status—All platform connection/auth/sync statusgateway/info—Version, device count, portsscene/list``platform (string)Scene listscene/trigger``platform, sceneIdTrigger result

Parameter convention: device/specs uses deviceId (camelCase); platform-specific tools ( xiaomi/*, tuya/*) use device_id (snake_case).

Sub-Skill Loading Strategy#

The main skill provides cross-platform tools. Load sub-skills on demand based on the user's platform:

Sub-SkillFileWhen to Loadfeyagate-xiaomiskills/xiaomi.mdXiaomi/Mi Home devices, cameras, XiaoAI speakersfeyagate-tuyaskills/tuya.mdTuya/Smart Life devicesfeyagate-mideaskills/midea.mdMidea/美的 appliancesfeyagate-ewelinkskills/ewelink.mdeWeLink/Sonoff devicesfeyagate-automationskills/automation.mdSchedule, triggers, rooms, memoryfeyagate-extensionskills/extension.mdSerial, GPIO, Xiaozhi AI, license

Workflow: device/list → device/specs → identify platform → load corresponding sub-skill

License#

• Free: Xiaomi platform (device control, cameras, XiaoAI, MCP proxy)

• Licensed: All platforms (Xiaomi + Tuya + Midea + eWeLink)

  • tuya/set_property, midea/set_property, ewelink/set_property return license_required on free edition
  • get_properties and read tools work without license

Configuration#

~/.feyagate/config/config.yaml:

yaml

server:
  http_port: 38080
  ws_port: 8765
  bind_address: "0.0.0.0"
auth:
  cloud_server: "cn"      # cn / de / sg / us / ru / i2
camera:
  frame_interval: 500
  jpeg_quality: 90
xiaozhi:
  endpoint: ""            # ws:// or wss:// (empty = disabled)

Troubleshooting#

SymptomFixcommand not found: feyagate``pip install feyagate-skill``FeyaGate not installed``feyagate setup``connection refused``feyagate start``authorized: false``feyagate auth or platform auth toolTool not foundCheck tools/list outputlicense_requiredSet license via license/set tool

Full API docs: FeyaGate_MCP_API.md, FeyaGate_HTTP_API.md