System management portmanteau for Robotics MCP.

PORTMANTEAU PATTERN RATIONALE: Instead of creating 3 separate tools (help, status, list_robots), this tool consolidates related system operations into a single interface. This design:

• Prevents tool explosion (3 tools -> 1 tool) while maintaining full functionality

• Improves discoverability by grouping related operations together

• Reduces cognitive load when working with system management tasks

• Enables consistent system interface across all operations

• Follows FastMCP 2.13+ best practices for feature-rich MCP servers

SUPPORTED OPERATIONS:

• help: Get comprehensive help information about the server and its tools

• status: Get server status with connectivity tests and robot counts

• list_robots: List all registered robots with optional filtering

Unified robot control with conversational responses.

Provides a single interface for controlling physical robots, virtual robots, and specialized devices with intelligent routing and rich conversational responses. Primary: Dreame D20 Pro vacuum. Also supports Yahboom ROSMASTER, Moorebot Scout, Unitree (when hardware available), and virtual robots in Unity/VRChat.

PORTMANTEAU PATTERN RATIONALE: Instead of creating separate tools for each robot type and operation, this tool consolidates all robot control operations into a single interface. This design:

• Prevents tool explosion (15+ tools -> 1 tool) while maintaining full functionality

• Enables seamless switching between physical and virtual robots

• Provides consistent error handling and safety protocols across all robot types

• Supports conversational AI interaction with context-aware responses

• Follows FastMCP 2.13+ best practices for feature-rich MCP servers

SUPPORTED ROBOT TYPES:

• Dreame D20 Pro: Primary platform - LIDAR vacuum with mapping, zone cleaning, mop, auto-empty

• Yahboom Robots: ROSMASTER series with AI, navigation, and optional robotic arms

• Moorebot Scout: ROS1 wheeled robot

• Elegoo Robots: ROS-on-PC robots with serial communication

• Unitree Go2/G1: Quadrupedal robots (when hardware available)

• Virtual Robots: Unity3D/VRChat robots

• Hue HomeAware: Philips Hue Bridge Pro with RF-based movement detection

SUPPORTED OPERATIONS:

• Universal: "get_status", "move", "stop"

• Physical Robots: "return_to_dock", "stand", "sit", "walk", "sync_vbot"

• Yahboom: "home_patrol", "camera_capture", "arm_move", "gripper_control", "navigate_to", "ai_query"

• Elegoo: "emergency_stop" (ROS-on-PC serial communication)

• Dreame: "start_auto_empty", "stop_auto_empty", "start_self_clean", "stop_self_clean", "set_suction_level", "set_water_volume", "set_mop_humidity", "clean_zone", "clean_spot", "start_mapping", "rename_room", "set_cleaning_sequence", "set_restricted_zones", "get_cleaning_history", "clear_error"

• Hue HomeAware: "hue_get_movement_events", "hue_get_sensor_status", "hue_get_movement_zones"

Robot behavior control portmanteau - Animation, camera, navigation, and manipulation.

PORTMANTEAU PATTERN: Consolidates animation, camera, navigation, and manipulation operations into a single unified tool. This reduces tool explosion while maintaining full functionality across all behavior categories.

CATEGORIES:

• animation: Animation and pose control

• camera: Camera feed and visual control

• navigation: Path planning and navigation

• manipulation: Arm and gripper control

ANIMATION ACTIONS:

• animate_wheels: Rotate wheels during movement (Scout mecanum wheels)

• animate_movement: Play movement animations (walk, turn, etc.)

• set_pose: Set robot pose (sitting, standing, etc. for Unitree)

• play_animation: Play custom animations

• stop_animation: Stop current animation

• get_animation_state: Get current animation state

CAMERA ACTIONS:

• get_camera_feed: Get live camera feed (physical Scout camera)

• get_virtual_camera: Get Unity camera view from robot perspective

• set_camera_angle: Adjust camera angle

• capture_image: Capture still image

• start_streaming: Start video stream

• stop_streaming: Stop video stream

• get_camera_status: Get camera status and settings

NAVIGATION ACTIONS:

• plan_path: Plan path from A to B (A* or RRT)

• follow_path: Execute planned path

• set_waypoint: Set navigation waypoint

• clear_waypoints: Clear waypoint list

• get_path_status: Check path execution status

• avoid_obstacle: Dynamic obstacle avoidance

• get_current_path: Get current path being followed

MANIPULATION ACTIONS:

• move_arm: Move arm to target joint positions or end-effector pose

• set_joint_positions: Set individual joint positions (dict of joint_name: angle)

• set_end_effector_pose: Move end-effector to target pose (position + orientation)

• get_arm_state: Get current arm joint positions and end-effector pose

• open_gripper: Open gripper fully

• close_gripper: Close gripper fully

• set_gripper_position: Set gripper position (0.0 = open, 1.0 = closed)

• get_gripper_state: Get current gripper position and force feedback

• move_to_pose: Move arm to target pose with IK (inverse kinematics)

• home_arm: Return arm to home/rest position

Manufacturing equipment control with conversational responses.

Provides unified control over 3D printers, CNC machines, and laser cutters with rich conversational responses for natural AI interaction. Supports complete manufacturing workflows from file upload to finished product.

PORTMANTEAU PATTERN RATIONALE: Instead of creating separate tools for each device type and operation, this tool consolidates manufacturing operations into a single interface. This design:

• Prevents tool explosion (9+ tools -> 1 tool) while maintaining full functionality

• Enables consistent manufacturing workflow across different device types

• Provides unified error handling and safety protocols

• Supports conversational AI interaction with rich response formats

• Follows FastMCP 2.13+ best practices for feature-rich MCP servers

SUPPORTED OPERATIONS:

• 3D Printers: Print control, monitoring, maintenance (OctoPrint/Moonraker)

• CNC Machines: Milling, drilling, cutting operations

• Laser Cutters: Vector cutting, engraving, material processing

Virtual robot lifecycle and operations portmanteau.

PORTMANTEAU PATTERN: Consolidates virtual robot CRUD operations and virtual robotics operations into a single unified tool. This reduces tool explosion while maintaining full functionality for virtual robot management.

CRUD OPERATIONS:

• create: Create/spawn and register a new virtual robot

• read: Get details of an existing virtual robot

• update: Modify virtual robot properties (scale, position, metadata, etc.)

• delete: Remove and unregister a virtual robot

• list: List all virtual robots with optional filtering

VIRTUAL ROBOT OPERATIONS:

• spawn: Spawn robot in Unity/VRChat scene (alias for create)

• load_environment: Load Marble/Chisel environment into scene

• get_status: Get virtual robot status

• get_lidar: Get virtual LiDAR scan (Unity physics raycast)

• set_scale: Scale robot size (for size testing)

• test_navigation: Test pathfinding in environment

• sync_with_physical: Sync vbot state with physical bot

Robot model management portmanteau for Robotics MCP.

PORTMANTEAU PATTERN RATIONALE: Instead of creating 4 separate tools (create, import, export, convert), this tool consolidates related model operations into a single interface. This design:

• Prevents tool explosion (4 tools -> 1 tool) while maintaining full functionality

• Improves discoverability by grouping related operations together

• Reduces cognitive load when working with robot models

• Enables consistent model interface across all operations

• Follows FastMCP 2.13+ best practices for feature-rich MCP servers

SUPPORTED OPERATIONS:

• create: Create robot 3D model from scratch using Blender MCP

• import: Import robot 3D model into Unity/VRChat/Resonite project

• export: Export robot model from Unity to file format

• convert: Convert robot model between formats

• spz_check: Check .spz conversion tool availability

• spz_convert: Convert .spz file to .ply or other format

• spz_extract: Extract metadata from .spz file

• spz_install: Install Unity Gaussian Splatting plugin (alternative to .spz)

• execute_script: Execute custom Blender Python script (like Gemini-generated scripts)

• list_scripts: List all available scripts in the repository by category

• execute_repository_script: Execute a script from the repository with optional parameters

CRUD operations for virtual robots (vbots).

This tool provides complete lifecycle management for virtual robots:

• Create: Spawn and register a new virtual robot

• Read: Get details of an existing virtual robot

• Update: Modify virtual robot properties (scale, position, metadata, etc.)

• Delete: Remove and unregister a virtual robot

• List: List all virtual robots with optional filtering

Supported robot types:

• "scout": Moorebot Scout (mecanum wheels, indoor)

• "scout_e": Moorebot Scout E (tracked, waterproof, outdoor)

• "go2": Unitree Go2 (quadruped)

• "g1": Unitree G1 (humanoid with arms)

• "yahboom": Yahboom ROSMASTER series (AI-enabled wheeled robots)

• "drone": Generic PX4/ArduPilot drones

• "px4_quad": PX4 quadcopter drones

• "ardupilot": ArduPilot-based drones

• "robbie": Robbie from Forbidden Planet (classic sci-fi robot)

• "custom": Custom robot type (requires model_path)

Comprehensive workflow management operations.

OPERATIONS:

• create: Create new workflow (requires workflow_data)

• read: Get workflow details (requires workflow_id)

• update: Update workflow (requires workflow_id, workflow_data)

• delete: Delete workflow (requires workflow_id)

• list: List all workflows (filterable by category, tags, search)

• execute: Execute workflow (requires workflow_id, variables)

• status: Get execution status (requires execution_id)

• templates: List available workflow templates

• import: Import workflow from JSON (requires workflow_data)

• export: Export workflow to JSON (requires workflow_id)

Core drone flight control operations with conversational responses.

Provides unified control interface for PX4/ArduPilot drones via MAVLink protocol or direct firmware integration. Supports both autonomous and manual flight modes with rich conversational responses for natural AI interaction.

Manage drone video streaming and recording with conversational responses.

Controls FPV video feeds, RTSP/WebRTC streaming, and onboard recording. Supports multiple protocols for real-time monitoring and data capture with intelligent quality adaptation and conversational status updates.

Manage drone navigation, waypoints, and geofencing with conversational responses.

Handles GPS navigation, waypoint missions, geofence boundaries, and follow-me modes with intelligent path planning and safety-aware navigation. Integrates with PX4/ArduPilot navigation systems and RTK positioning for precise aerial operations.

Manage advanced drone flight control, missions, and parameters with conversational responses.

Provides fine-grained control over PX4/ArduPilot flight modes, autonomous mission execution, and drone parameter tuning for advanced flight operations with intelligent mission planning and parameter optimization recommendations.

Dreame D20 Pro vacuum control with conversational responses.

Provides unified interface for Dreame vacuum operations: status, battery, water level, suction, LIDAR map, cleaning programs, zone/spot/room cleaning, and configuration.

Operations:

• get_status: Battery, water, suction, charging state, device status

• start_cleaning / stop_cleaning: Full-house or spot cleaning

• return_to_dock: Return to charging dock

• move: Manual drive (rotation, velocity)

• play_sound: Locate robot

• set_suction_level: Suction power 1-4

• set_water_volume: Water flow 1-3

• set_mop_humidity: Mop pad humidity 1-3

• get_map: LIDAR map data (rooms, walls, robot/charger positions)

• export_map: Export LIDAR map to OBJ/PLY/Unity/Blender formats

• clean_zone / clean_spot / clean_room: Targeted cleaning

• get_cleaning_history / clear_error: History and error recovery

Dreame D20 Pro Plus — DreameHome cloud setup (no local token).

This server uses the DreameHome cloud API. Set environment variables and optionally the Tasshack ref clone path. No network discovery or miio token needed.

Returns: Setup instructions and env var reference.

Noetix Bumi humanoid robot — features, specs, and SDK links.

Operations: info — return features, specs, GitHub and docs links (default)

Returns: success, message, and data (specs, features, github, docs).

Manage Gazebo Fuel simulation models - browse, download, and spawn.

Browse, download, and spawn 3000+ free models from Gazebo Fuel (fuel.gazebosim.org) into your Gazebo simulation environment.

Sim-art fleet bridge via gimp-mcp HTTP (Gazebo icons, VRChat, avatar thumbs).

Uses HTTP tool calls instead of mounting gimp-mcp stdio (avoids protocol hangs).

Operations: gimp_status: Probe gimp-mcp health and list sim-art templates. batch_gazebo_icons: Run gimp_sim_art_tool gazebo_model_icons on input_dir. import_gazebo_models: Batch import thumbnails into models_root (auto_import). batch_vrchat_icons: Run vrchat_icon_batch on input_dir. avatar_thumbnail: Push icon_path to avatar via avatar_manager set_thumbnail.

Fab art fleet bridge via inkscape-mcp HTTP (DXF, laser dots, Gazebo schematics).

Operations: inkscape_status: Probe inkscape-mcp and list fab presets. batch_dxf_export: Run inkscape_fab_art batch_dxf_export on input_dir. batch_laser_dots: Generate laser dot SVG batch from preset. gazebo_schematic: SVG to PNG schematic for model documentation. stage_fab_paths: Stage DXF/SVG/PNG outputs for robotics workflows. push_gimp_schematic: Export schematic and push through gimp validation.

Execute a complex, multi-step robotics workflow leveraging MCP sampling.

Probe all registered simulation MCP backends and report availability.

Checks: mujoco-mcp (MuJoCo), gazebo-mcp (Gazebo), isaac-mcp (Isaac Sim), limx-robotics-mcp (LimX). Returns health data, strengths, and ports for each.

Route a simulation task to the best available backend.

Probes all running sim MCPs, picks the optimal one based on task keywords (sensors → Gazebo, rendering → Isaac, locomotion → MuJoCo, TRON 1/Oli → LimX), and returns the backend URL and metadata. The caller then makes the actual API call to that backend.

List all registered sim backends and their capabilities (offline registry).

Search the robot model marketplace for available models.

Filters by keyword, tags, sim backend, or robot type. When exact keyword match returns nothing, falls back to a local LLM (Ollama) to suggest the closest catalog entry.

Return Format

{"success": bool, "message": str, "matches": [{ "id", "name", "type", "tags", "sim_backends", "formats", "joint_count", "actuator_count" }], "total": int, "llm_fallback_used": bool}

Examples

sim_marketplace_search_tool(query="go2") sim_marketplace_search_tool(tags=["humanoid", "unitree"]) sim_marketplace_search_tool(sim_backend="gazebo")

Get full metadata for a specific robot model from the marketplace.

Returns file paths (MJCF, URDF), compatible sim backends, joint/actuator counts, and source URLs.

Return Format

{"success": bool, "message": str, "model": {"id": str, "name": str, ...} | None}

Examples

sim_marketplace_info_tool(model_id="unitree_go2") sim_marketplace_info_tool(model_id="limx_oli_d04")

Handle specialized environmental and substrate logistics.

Covers everything from textiles and darkroom film to wildlife search & rescue, autonomous security patrols, pet logistics, pool supervision, human health, and mural painting.