How do I use Fancy Control MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Fancy Control MCP Server Shock my device at 70% power" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Fancy Control MCP Server

🌐 Language / Langue : English | Français

🇬🇧 English

HTTP Streamable MCP (Model Context Protocol) server for controlling PowerExchange/Fancy Control devices.

Features

Tool	Description
`device_config`	Check or save device configuration (SSID, password, serial, key)
`tilt`	Check or save device tilt position value
`pet_training_freeze`	PET TRAINING FREEZE (BETA) - Activate Pet Training freeze mode (S2Z) - must stay still
`pet_training_fast`	PET TRAINING FAST - Activate Pet Training fast mode (S2F) - faster response
`warning_buzzer`	Enable/disable the warning buzzer
`pet_training`	Pet Training mode (normal/S2)
`sleep_deprivation`	Sleep Deprivation mode
`random_mode`	Random mode - random activation
`timer`	Timer mode (on/off, get, t1_up/t1_down, t2_up/t2_down)
`beep`	Send a beep (short press equivalent)
`shock`	Send a shock with power 1-100% (long press equivalent)
`power_control`	Power level control
`send_raw_command`	Raw HTTP command for advanced users

Architecture

MCP Client ──────► Raspberry Pi ──────► Fancy Device
             eth0 (Ethernet)     wlan0 (WiFi)
             Port 8000           Port 80

Quick Start

On Raspberry Pi (ARM64) with Docker

git clone <repository-url>
cd fancy-mcp-server

# Build the image
docker build -t fancy-mcp-server .

# Run the container
docker run -d \
  --name fancy-mcp-server \
  --restart unless-stopped \
  -p 8000:8000 \
  -e MCP_AUTH_TOKEN=your-secure-token \
  -e DEVICE_IP=192.168.4.1 \
  -e DEVICE_PORT=80 \
  -e MCP_CONTEXT_DESCRIPTION="My Fancy device" \
  fancy-mcp-server

With docker-compose

git clone <repository-url>
cd fancy-mcp-server
cp .env.example .env
# Edit .env with your settings
docker compose up -d

See RASPBERRY_PI_SETUP.md for complete WiFi configuration.

Without Docker (Python)

pip install -r requirements.txt
export MCP_AUTH_TOKEN=your-token
export DEVICE_IP=192.168.4.1
python server.py

Environment Variables

Basic Configuration

Variable	Required	Default	Description
`MCP_AUTH_TOKEN`	Yes	-	MCP authentication token
`DEVICE_IP`	Yes	-	Device IP address
`DEVICE_PORT`	No	80	Device HTTP port
`MCP_CONTEXT_DESCRIPTION`	No	-	Prefix added to all descriptions
`PORT`	No	8000	MCP server port
`MCP_SAFETY_MAX_POWER_0_100`	No	-	Safety: Maximum power limit (0-100). If set, all power commands (shock, power_control) will be capped at this value

Tool Descriptions (customizable)

Each tool has its own variable to customize its description:

Variable	Default Description
`TOOL_DESC_DEVICE_CONFIG`	Device Config - Check or save device configuration...
`TOOL_DESC_TILT`	Tilt - Check or save the device tilt position value
`TOOL_DESC_PET_TRAINING_FREEZE`	PET TRAINING FREEZE (BETA) - Activate Pet Training freeze mode...
`TOOL_DESC_PET_TRAINING_FAST`	PET TRAINING FAST - Activate Pet Training fast mode...
`TOOL_DESC_WARNING_BUZZER`	Warning Buzzer - Enable or disable the warning buzzer...
`TOOL_DESC_PET_TRAINING`	Pet Training Mode - Enable or disable pet training...
`TOOL_DESC_SLEEP_DEPRIVATION`	Sleep Deprivation Mode - Enable or disable...
`TOOL_DESC_RANDOM_MODE`	Random Mode - Enable or disable random activation...
`TOOL_DESC_TIMER`	Timer Mode - Enable or disable timer mode...
`TOOL_DESC_BEEP`	Beep - Send a beep signal to the device...
`TOOL_DESC_SHOCK`	Shock - Send a shock signal with specified power...
`TOOL_DESC_POWER_CONTROL`	Power Control - Adjust the device power level
`TOOL_DESC_SEND_RAW_COMMAND`	Send a raw HTTP command to the device...

API Endpoints

Endpoint	Method	Description
`/mcp`	POST	Main MCP endpoint (JSON-RPC)
`/health`	GET	Health check
`/`	GET	Server info

Authentication

The server accepts the token with or without "Bearer" prefix:

# With Bearer
-H "Authorization: Bearer your-token"

# Without Bearer
-H "Authorization: your-token"

Usage Examples

Health Check

curl http://192.168.1.100:8000/health

List Tools

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: your-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

Send a Beep

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: your-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "beep", "arguments": {}}}'

Shock at 50% Power

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: your-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "shock", "arguments": {"power": 50}}}'

Enable Pet Training Freeze

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: your-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "pet_training_freeze", "arguments": {"action": "on"}}}'

Enable Timer Mode

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: your-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "timer", "arguments": {"action": "on"}}}'

Get Timer Values

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: your-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "timer", "arguments": {"action": "get"}}}'

Increase Timer 1

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: your-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "timer", "arguments": {"action": "t1_up"}}}'

Device Endpoints

Function	Endpoint
Device Config Check	`/TX?`
Device Config Save	`/TX?SSIDX=<ssid>&PASSX=<password>`
Tilt Check	`/DIS/BOW`
Tilt Save	`/TX?TILTVAL=<value>`
Pet Training Freeze ON	`/mode/S2Z`
Pet Training Freeze OFF	`/mode/0`
Pet Training Fast ON	`/mode/S2F`
Pet Training Fast OFF	`/mode/0`
Buzzer ON	`/S1/1`
Buzzer OFF	`/S1/0`
Pet Training	`/mode/S2`
Sleep Deprivation	`/mode/S4`
Random	`/mode/RN`
Timer Mode	`/mode/TM`
Timer Get	`/DIS/TM`
Timer 1 +	`/T1/+`
Timer 1 -	`/T1/-`
Timer 2 +	`/T2/+`
Timer 2 -	`/T2/-`
Mode OFF	`/mode/0`
Beep	`/B1/1`
Shock	`/Z1/1`
Power +	`/PW/+`
Power -	`/PW/-`

Docker

Build

docker build -t fancy-mcp-server .

Run (minimal config)

docker run -d \
  --name fancy-mcp-server \
  --restart unless-stopped \
  -p 8000:8000 \
  -e MCP_AUTH_TOKEN=your-token \
  -e DEVICE_IP=192.168.4.1 \
  fancy-mcp-server

Run (full config with custom descriptions)

docker run -d \
  --name fancy-mcp-server \
  --restart unless-stopped \
  -p 8000:8000 \
  -e MCP_AUTH_TOKEN=your-token \
  -e DEVICE_IP=192.168.4.1 \
  -e DEVICE_PORT=80 \
  -e MCP_CONTEXT_DESCRIPTION="My Device" \
  -e MCP_SAFETY_MAX_POWER_0_100=50 \
  -e TOOL_DESC_DEVICE_CONFIG="Device config" \
  -e TOOL_DESC_TILT="Tilt" \
  -e TOOL_DESC_PET_TRAINING_FREEZE="Freeze training mode" \
  -e TOOL_DESC_PET_TRAINING_FAST="Fast training mode" \
  -e TOOL_DESC_WARNING_BUZZER="Warning buzzer" \
  -e TOOL_DESC_PET_TRAINING="Training mode" \
  -e TOOL_DESC_SLEEP_DEPRIVATION="Sleep deprivation mode" \
  -e TOOL_DESC_RANDOM_MODE="Random mode" \
  -e TOOL_DESC_TIMER="Timer" \
  -e TOOL_DESC_BEEP="Send a beep" \
  -e TOOL_DESC_SHOCK="Send a shock" \
  -e TOOL_DESC_POWER_CONTROL="Power control" \
  -e TOOL_DESC_SEND_RAW_COMMAND="Raw command" \
  fancy-mcp-server

Safety Note: The MCP_SAFETY_MAX_POWER_0_100 variable limits the maximum power. In the example above, even if a shock is requested at 100%, it will be limited to 50%.

Stop / Remove

docker stop fancy-mcp-server
docker rm fancy-mcp-server

Logs

docker logs -f fancy-mcp-server

With docker-compose

docker compose build
docker compose up -d
docker compose logs -f

MCP Compliance

Protocol Version: 2024-11-05
Transport: HTTP Streamable
Format: JSON-RPC 2.0
Methods: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get, ping

🇫🇷 Français

Serveur MCP (Model Context Protocol) HTTP Streamable pour contrôler les appareils PowerExchange/Fancy Control.

Fonctionnalités

Outil	Description
`device_config`	Vérifie ou sauvegarde la configuration du device (SSID, mot de passe, numéro de série, clé)
`tilt`	Vérifie ou sauvegarde la valeur de position d'inclinaison du device
`pet_training_freeze`	PET TRAINING FREEZE (BETA) - Active le mode Pet Training freeze (S2Z) - doit rester immobile
`pet_training_fast`	PET TRAINING FAST - Active le mode Pet Training rapide (S2F) - réponse plus rapide
`warning_buzzer`	Active/désactive le buzzer d'avertissement
`pet_training`	Mode Pet Training (normal/S2)
`sleep_deprivation`	Mode Sleep Deprivation
`random_mode`	Mode Random - activation aléatoire
`timer`	Mode Timer (on/off, get, t1_up/t1_down, t2_up/t2_down)
`beep`	Envoie un bip (équivalent appui court)
`shock`	Envoie un shock avec puissance 1-100% (équivalent appui long)
`power_control`	Contrôle du niveau de puissance
`send_raw_command`	Commande HTTP brute pour utilisateurs avancés

Architecture

Client MCP ──────► Raspberry Pi ──────► Device Fancy
             eth0 (Ethernet)     wlan0 (WiFi)
             Port 8000           Port 80

Installation rapide

Sur Raspberry Pi (ARM64) avec Docker

git clone <repository-url>
cd fancy-mcp-server

# Build de l'image
docker build -t fancy-mcp-server .

# Lancer le container
docker run -d \
  --name fancy-mcp-server \
  --restart unless-stopped \
  -p 8000:8000 \
  -e MCP_AUTH_TOKEN=votre-token-securise \
  -e DEVICE_IP=192.168.4.1 \
  -e DEVICE_PORT=80 \
  -e MCP_CONTEXT_DESCRIPTION="Mon device Fancy" \
  fancy-mcp-server

Avec docker-compose

git clone <repository-url>
cd fancy-mcp-server
cp .env.example .env
# Éditer .env avec vos paramètres
docker compose up -d

Voir RASPBERRY_PI_SETUP.md pour la configuration WiFi complète.

Sans Docker (Python)

pip install -r requirements.txt
export MCP_AUTH_TOKEN=votre-token
export DEVICE_IP=192.168.4.1
python server.py

Variables d'environnement

Configuration de base

Variable	Requis	Défaut	Description
`MCP_AUTH_TOKEN`	Oui	-	Token d'authentification MCP
`DEVICE_IP`	Oui	-	Adresse IP du device
`DEVICE_PORT`	Non	80	Port HTTP du device
`MCP_CONTEXT_DESCRIPTION`	Non	-	Préfixe ajouté à toutes les descriptions
`PORT`	Non	8000	Port du serveur MCP
`MCP_SAFETY_MAX_POWER_0_100`	Non	-	Sécurité : Limite maximale de puissance (0-100). Si définie, toutes les commandes de puissance (shock, power_control) seront plafonnées à cette valeur

Descriptions des outils (personnalisables)

Chaque outil a sa propre variable pour personnaliser sa description :

Variable	Description par défaut
`TOOL_DESC_DEVICE_CONFIG`	Device Config - Check or save device configuration...
`TOOL_DESC_TILT`	Tilt - Check or save the device tilt position value
`TOOL_DESC_PET_TRAINING_FREEZE`	PET TRAINING FREEZE (BETA) - Activate Pet Training freeze mode...
`TOOL_DESC_PET_TRAINING_FAST`	PET TRAINING FAST - Activate Pet Training fast mode...
`TOOL_DESC_WARNING_BUZZER`	Warning Buzzer - Enable or disable the warning buzzer...
`TOOL_DESC_PET_TRAINING`	Pet Training Mode - Enable or disable pet training...
`TOOL_DESC_SLEEP_DEPRIVATION`	Sleep Deprivation Mode - Enable or disable...
`TOOL_DESC_RANDOM_MODE`	Random Mode - Enable or disable random activation...
`TOOL_DESC_TIMER`	Timer Mode - Enable or disable timer mode...
`TOOL_DESC_BEEP`	Beep - Send a beep signal to the device...
`TOOL_DESC_SHOCK`	Shock - Send a shock signal with specified power...
`TOOL_DESC_POWER_CONTROL`	Power Control - Adjust the device power level
`TOOL_DESC_SEND_RAW_COMMAND`	Send a raw HTTP command to the device...

Endpoints API

Endpoint	Méthode	Description
`/mcp`	POST	Endpoint MCP principal (JSON-RPC)
`/health`	GET	Health check
`/`	GET	Info serveur

Authentification

Le serveur accepte le token avec ou sans préfixe "Bearer" :

# Avec Bearer
-H "Authorization: Bearer votre-token"

# Sans Bearer
-H "Authorization: votre-token"

Exemples d'utilisation

Health Check

curl http://192.168.1.100:8000/health

Liste des outils

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: votre-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

Envoyer un Beep

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: votre-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "beep", "arguments": {}}}'

Shock à 50% de puissance

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: votre-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "shock", "arguments": {"power": 50}}}'

Activer Pet Training Freeze

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: votre-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "pet_training_freeze", "arguments": {"action": "on"}}}'

Activer le mode Timer

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: votre-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "timer", "arguments": {"action": "on"}}}'

Lire les valeurs Timer

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: votre-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "timer", "arguments": {"action": "get"}}}'

Augmenter Timer 1

curl -X POST http://192.168.1.100:8000/mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: votre-token" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "timer", "arguments": {"action": "t1_up"}}}'

Endpoints du Device

Fonction	Endpoint
Config Device (check)	`/TX?`
Config Device (save)	`/TX?SSIDX=<ssid>&PASSX=<password>`
Tilt (check)	`/DIS/BOW`
Tilt (save)	`/TX?TILTVAL=<valeur>`
Pet Training Freeze ON	`/mode/S2Z`
Pet Training Freeze OFF	`/mode/0`
Pet Training Fast ON	`/mode/S2F`
Pet Training Fast OFF	`/mode/0`
Buzzer ON	`/S1/1`
Buzzer OFF	`/S1/0`
Pet Training	`/mode/S2`
Sleep Deprivation	`/mode/S4`
Random	`/mode/RN`
Timer Mode	`/mode/TM`
Timer Get	`/DIS/TM`
Timer 1 +	`/T1/+`
Timer 1 -	`/T1/-`
Timer 2 +	`/T2/+`
Timer 2 -	`/T2/-`
Mode OFF	`/mode/0`
Beep	`/B1/1`
Shock	`/Z1/1`
Power +	`/PW/+`
Power -	`/PW/-`

Docker

Build

docker build -t fancy-mcp-server .

Lancer (config minimale)

docker run -d \
  --name fancy-mcp-server \
  --restart unless-stopped \
  -p 8000:8000 \
  -e MCP_AUTH_TOKEN=votre-token \
  -e DEVICE_IP=192.168.4.1 \
  fancy-mcp-server

Lancer (config complète avec descriptions personnalisées)

docker run -d \
  --name fancy-mcp-server \
  --restart unless-stopped \
  -p 8000:8000 \
  -e MCP_AUTH_TOKEN=votre-token \
  -e DEVICE_IP=192.168.4.1 \
  -e DEVICE_PORT=80 \
  -e MCP_CONTEXT_DESCRIPTION="Mon Device" \
  -e MCP_SAFETY_MAX_POWER_0_100=50 \
  -e TOOL_DESC_DEVICE_CONFIG="Configuration device" \
  -e TOOL_DESC_TILT="Inclinaison" \
  -e TOOL_DESC_PET_TRAINING_FREEZE="Mode dressage freeze" \
  -e TOOL_DESC_PET_TRAINING_FAST="Mode dressage rapide" \
  -e TOOL_DESC_WARNING_BUZZER="Buzzer d'avertissement" \
  -e TOOL_DESC_PET_TRAINING="Mode dressage" \
  -e TOOL_DESC_SLEEP_DEPRIVATION="Mode privation de sommeil" \
  -e TOOL_DESC_RANDOM_MODE="Mode aléatoire" \
  -e TOOL_DESC_TIMER="Minuterie" \
  -e TOOL_DESC_BEEP="Émettre un bip" \
  -e TOOL_DESC_SHOCK="Envoyer une décharge" \
  -e TOOL_DESC_POWER_CONTROL="Contrôle de puissance" \
  -e TOOL_DESC_SEND_RAW_COMMAND="Commande brute" \
  fancy-mcp-server

Note sécurité : La variable MCP_SAFETY_MAX_POWER_0_100 permet de limiter la puissance maximale. Dans l'exemple ci-dessus, même si un shock est demandé à 100%, il sera limité à 50%.

Arrêter / Supprimer

docker stop fancy-mcp-server
docker rm fancy-mcp-server

Logs

docker logs -f fancy-mcp-server

Avec docker-compose

docker compose build
docker compose up -d
docker compose logs -f

Conformité MCP

Protocol Version: 2024-11-05
Transport: HTTP Streamable
Format: JSON-RPC 2.0
Méthodes: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get, ping

License

MIT License

Fancy Control MCP Server

🇬🇧 English

Features

Architecture

Quick Start

On Raspberry Pi (ARM64) with Docker

With docker-compose

Without Docker (Python)

Environment Variables

Basic Configuration

Tool Descriptions (customizable)

API Endpoints

Authentication

Usage Examples

Health Check

List Tools

Send a Beep

Shock at 50% Power

Enable Pet Training Freeze

Enable Timer Mode

Get Timer Values

Increase Timer 1

Device Endpoints

Docker

Build

Run (minimal config)

Run (full config with custom descriptions)

Stop / Remove

Logs

With docker-compose

MCP Compliance

🇫🇷 Français

Fonctionnalités

Architecture

Installation rapide

Sur Raspberry Pi (ARM64) avec Docker

Avec docker-compose

Sans Docker (Python)

Variables d'environnement

Configuration de base

Descriptions des outils (personnalisables)

Endpoints API

Authentification

Exemples d'utilisation

Health Check

Liste des outils

Envoyer un Beep

Shock à 50% de puissance

Activer Pet Training Freeze

Activer le mode Timer

Lire les valeurs Timer

Augmenter Timer 1

Endpoints du Device

Docker

Build

Lancer (config minimale)

Lancer (config complète avec descriptions personnalisées)

Arrêter / Supprimer

Logs

Avec docker-compose

Conformité MCP

License

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API