Documentation · PCK-MMXXVI-C4A32096

From zero to
first tool call
in 5 minutes.

Complete reference for the Pclika MCP Platform — bridge setup, firmware, tool schemas, prompt templates, and troubleshooting.

Quickstart — 5 minutes

Connect AI to hardware

Install the Python bridge

pip install ./bridge/mcp-server

Requires Python 3.10+ and pyserial

Clone and flash the firmware

git clone https://github.com/Pclika/mcp-platform
cd mcp-platform/examples/hello-mcp
idf.py set-target esp32s3
idf.py build flash monitor

Requires ESP-IDF v5.x installed

claude mcp add pclika-bridge -- pclika-bridge --port /dev/ttyUSB0

On Windows: --port COM3 On macOS: --port /dev/cu.usbserial-*

Verify the connection

device_info()

Returns board ID, FW version, seal, and capabilities list

Read your first sensor

sensor_read(sensor_id="temp_humidity")

→ { value: 24.3, unit: "°C", timestamp_ms: 12840 }

MCP Tool Reference

Tool	Required params	Returns	Schema
device_info	—	board_id, fw_version, capabilities	base
sensor_read	sensor_id	value, unit, timestamp_ms	base
display_text	text	ok, lines_written	base
servo_move	angle	ok, channel, angle, duration_ms	base
led_control	state	ok, state	base
button_read	—	pressed, press_count	base
wifi_scan	—	networks[], count, scan_time_ms	base
gpio_read	pin	pin, level, pull	base
gpio_write	pin, level	ok, pin, level	base
serial_log_read	—	lines[], count	base
firmware_version	—	version, idf_version, seal	base
env_read	—	temperature_c, humidity_pct, pressure_hpa	sensor
imu_read	—	accel{x,y,z}, gyro{x,y,z}	sensor
distance_read	—	distance_mm, valid	sensor
light_read	—	lux, raw	sensor
camera_capture	—	base64 JPEG, width, height	vision
camera_status	—	initialized, sensor_model, fps	vision
modbus_read	slave_id, function, address, count	values[], ok	industrial
relay_set	channel, state	ok, all_states	industrial
adc_read_multi	channels[]	readings[{ch, raw, voltage}]	industrial
servo_sweep	—	ok, mode	motion
motor_set	channel, speed, direction	ok	motion
stepper_move	steps	ok, steps_moved, position_steps	motion