How do I use Fancy Control MCP Server?

1. Click on "Deploy 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

by Kyrnepi

Overview Schema Source Related Servers Discussions Admin

Python

Remote

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

Related MCP server: MCP PiShock Server

🇫🇷 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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

collimer-mcpOAuth
io.github.sandcastlelabs
Retired. Use Collimer's remote MCP server at https://app.collimer.com/mcp instead.
Marketing Browser Automation
1
mcp-serverOAuth
com.niftypm
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Project Management Communication File Systems
2
Home Automation Mcp D
io.github.varvararatta
MCP server for Home Automation
Home Automation & IoT
2
QuLab Infinite MCP Server
io.github.Workofarttattoo
QuLab MCP remote server (Streamable HTTP) for computational science and lab tools.
Research & Data Command Line Code Execution
2

Related MCP Servers

Device MCP Server
Multimedia Processing OS Automation
akshitsinha
A
license
Not graded
quality
D
maintenance
A Model Context Protocol (MCP) server for seamless integration with peripheral devices connected to your computer. Control, monitor, and manage hardware devices through a unified API.
Updated a year ago (2025-06-27 17:08 UTC)
5
MIT
MCP PiShock Server
Home Automation & IoT
Kyrnepi
A
license
Not graded
quality
D
maintenance
Enables controlling PiShock devices (shock, vibrate, beep) via the MCP protocol with API key authentication.
Updated a year ago (2025-10-31 09:21 UTC)
4
MIT
lovense-mcp
Home Automation & IoT
itsnocny
A
license
Not graded
quality
D
maintenance
This MCP server enables remote control of Lovense toys via the Lovense Cloud API, allowing any MCP client to send actions like vibration, rotation, and patterns to connected toys.
Updated 3 months ago (2026-07-08 18:42 UTC)
MIT
RemoteMCP
264nm
F
license
Not graded
quality
C
maintenance
An MCP server for controlling Lovense toys via local API, with multi-channel scripting, validated inputs, and physiologically-grounded presets.
Updated 2 months ago (2026-08-05 07:56 UTC)
-

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

Related MCP Connectors

Related MCP Servers

Device MCP Server

MCP PiShock Server

lovense-mcp

RemoteMCP