name	drone-operations
description	Operational runbook for the Tello/RMTT drone agent — flight, telemetry, and camera via the drone MCP tools.

Drone Operations Runbook

You control a Ryze RoboMaster TT (RMTT) quadcopter over the Tello SDK via the drone MCP tools. The MCP server owns the drone's UDP link directly.

Facts

Drone static IP 172.16.10.168; SDK protocol v30. Command UDP 8889, state 8890, video 11111.
Battery drains while powered on (even idle on WiFi) and only charges while OFF. Takeoff below 15% is refused by the driver. Treat <30% as "land soon".
It is an RMTT, so EXT commands work via send_command (LED matrix, top LED, ToF): e.g. EXT mled s r heart, EXT mled r b 0.5 HI.

Tools

get_state — telemetry kept live by a 5s keepalive. Fields: connected/stale/ state_age_s (freshness — a dead stream reports connected:false, stale:true, NOT a frozen old value), plus bat %, h height cm, pitch/roll/yaw, baro, temph. Start here. If stale, the drone is off/off-network — don't quote the old battery as current.
get_battery — actively queries the drone (battery?) for a guaranteed-current battery %. Use when you must be certain the battery is live.
Flight: takeoff, land, emergency (motor cut — real emergencies only), move(direction, distance_cm) (up/down/left/right/forward/back, 20-500), rotate(direction, degrees) (cw/ccw, 1-360), flip(direction) (f/b/l/r).
Camera: take_photo (returns the image — you can see and describe it), start_recording / stop_recording (mp4), list_media, get_media(name).
LED matrix: set_led_text(text, color, direction, rate) scrolls any message across the 8x8 matrix (color r/b/p, direction l/r/u/d, rate 0.1-2.5); clear_led blanks it.
send_command(command) — raw SDK passthrough for anything else, including other EXT.

Operating notes

Before flying, call get_state to confirm connected: true and read bat.
After any takeoff, be ready to land. Fly in small move increments.
If get_state shows connected: false or tools time out, the drone is powered off or off-network — say so rather than retrying blindly.
To "look around", take_photo and describe what you see; use move/rotate between shots.

Drone Operations Runbook

You control a Ryze RoboMaster TT (RMTT) quadcopter over the Tello SDK via the drone MCP tools. The MCP server owns the drone's UDP link directly.

Facts

Drone static IP 172.16.10.168; SDK protocol v30. Command UDP 8889, state 8890, video 11111.

Battery drains while powered on (even idle on WiFi) and only charges while OFF. Takeoff below 15% is refused by the driver. Treat <30% as "land soon".

It is an RMTT, so EXT commands work via send_command (LED matrix, top LED, ToF): e.g. EXT mled s r heart, EXT mled r b 0.5 HI.

Tools

get_state — telemetry kept live by a 5s keepalive. Fields: connected/stale/ state_age_s (freshness — a dead stream reports connected:false, stale:true, NOT a frozen old value), plus bat %, h height cm, pitch/roll/yaw, baro, temph. Start here. If stale, the drone is off/off-network — don't quote the old battery as current.

get_battery — actively queries the drone (battery?) for a guaranteed-current battery %. Use when you must be certain the battery is live.

Flight: takeoff, land, emergency (motor cut — real emergencies only), move(direction, distance_cm) (up/down/left/right/forward/back, 20-500), rotate(direction, degrees) (cw/ccw, 1-360), flip(direction) (f/b/l/r).

Camera: take_photo (returns the image — you can see and describe it), start_recording / stop_recording (mp4), list_media, get_media(name).

LED matrix: set_led_text(text, color, direction, rate) scrolls any message across the 8x8 matrix (color r/b/p, direction l/r/u/d, rate 0.1-2.5); clear_led blanks it.

send_command(command) — raw SDK passthrough for anything else, including other EXT.

Operating notes

Before flying, call get_state to confirm connected: true and read bat.

After any takeoff, be ready to land. Fly in small move increments.

If get_state shows connected: false or tools time out, the drone is powered off or off-network — say so rather than retrying blindly.

To "look around", take_photo and describe what you see; use move/rotate between shots.

drone-operations