esp-cyd-mcp MCP Server

A comprehensive Model Context Protocol (MCP) server implementation for the ESP32 CYD (Cheap Yellow Display) board. This project provides extensive remote control capabilities for the ESP32-2432S028R…

Local serverstdio

What is the esp-cyd-mcp Server?

esp-cyd-mcp is an MCP project maintained in the ofryl/esp-cyd-mcp repository. The maintainer describes its purpose as “A comprehensive Model Context Protocol (MCP) server implementation for the ESP32 CYD (Cheap Yellow Display) board. This project provides extensive remote control capabilities for the…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using websocat. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
display.clearClear screen with color
display.textDraw text with positioning and styling
display.lineDraw lines with thickness
display.rectangleDraw rectangle outlines
display.fillRectangleDraw filled rectangles
display.circleDraw circle outlines
display.fillCircleDraw filled circles
display.pixelDraw individual pixels
display.backlightControl backlight on/off
display.brightnessSet display brightness (0-255)
display.rotationSet display rotation (0-3)
display.progressBarDraw progress bars
display.infoGet display information
touch.getStateGet current touch state
touch.enableEnable/disable touch input
touch.calibrateCalibrate touch screen
touch.getHistoryGet recent touch events
touch.simulateSimulate touch events
touch.getCalibrationGet calibration values
touch.saveCalibrationSave calibration to file
gpio.pinModeSet pin mode (input/output/PWM)
gpio.digitalWriteWrite digital value
gpio.digitalReadRead digital value
gpio.analogWritePWM output
gpio.analogReadRead analog value
gpio.attachInterruptAttach interrupts
gpio.setPWMConfigure PWM with frequency
gpio.toneGenerate tones
gpio.pulseInMeasure pulse duration
sensor.readTemperatureRead temperature sensor
sensor.readLightRead light sensor
sensor.readInternalTempESP32 internal temperature
sensor.readHallSensorBuilt-in hall sensor
sensor.readBatteryVoltagePower supply voltage
sensor.readAllRead all sensors at once
sensor.calibrateCalibrate sensors
sensor.getEnvironmentEnvironmental summary
network.statusGet network status
network.connectConnect to WiFi
network.scanScan for networks
network.startAPStart access point
network.httpRequestMake HTTP requests
network.pingPing hosts
network.getTimeGet NTP time
network.setMDNSConfigure mDNS
system.infoComprehensive system information
system.restartRestart ESP32
system.sleepDeep/light sleep modes
system.memoryMemory statistics
system.tasksFreeRTOS task info
system.setCPUFrequencyCPU speed control
system.performanceModePerformance optimization
system.factoryResetFactory reset
file.listList files/directories
file.readRead file contents
file.writeWrite to file
file.deleteDelete files
file.mkdirCreate directories
file.copyCopy files
file.storageStorage statistics
audio.tonePlay single tone
audio.playMelodyPlay melodies
audio.beepSimple beep sounds
audio.playPatternCustom tone patterns
audio.notificationNotification sounds
audio.alarmAlarm patterns
audio.setVolumeVolume control

How to install the esp-cyd-mcp Server

{
  "mcpServers": {
    "esp32-cyd": {
      "command": "websocat",
      "args": [
        "ws://192.168.1.100:3001"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.