Labsco
yerbymatey logo

Opentrons

★ 6

from yerbymatey

Control Opentrons robots, manage protocols, and search API documentation.

🔥🔥🔥✓ VerifiedFreeQuick setup
#automation#git#monitoring

Opentrons MCP Server

A Model Context Protocol (MCP) server for Opentrons robot automation and API documentation. This tool provides both comprehensive API documentation and direct robot control capabilities for Opentrons Flex and OT-2 robots.

Features

API Documentation Tools

  • Search Endpoints: Find API endpoints by functionality, method, or keyword
  • Endpoint Details: Get comprehensive information about specific API endpoints
  • Category Browsing: List endpoints by functional category
  • API Overview: High-level overview of the entire Opentrons HTTP API

Robot Automation Tools

  • Protocol Management: Upload, list, and manage protocol files
  • Run Control: Create runs, start/stop execution, monitor progress
  • Robot Health: Check connectivity and system status
  • Hardware Control: Home robot, control lights, and basic operations

Available Tools

Documentation Tools

search_endpoints

Search Opentrons HTTP API endpoints by functionality, method, path, or keyword.

  • query (required): Search term
  • method (optional): Filter by HTTP method (GET, POST, PUT, DELETE, PATCH)
  • tag (optional): Filter by API category
  • include_deprecated (optional): Include deprecated endpoints

get_endpoint_details

Get comprehensive details about a specific API endpoint.

  • method (required): HTTP method
  • path (required): API endpoint path

list_by_category

List all endpoints in a specific functional category.

  • category (required): API category (Health, Control, Protocol Management, etc.)

get_api_overview

Get high-level overview of the Opentrons HTTP API structure and capabilities.

Automation Tools

upload_protocol

Upload a protocol file to an Opentrons robot.

  • robot_ip (required): Robot IP address
  • file_path (required): Path to protocol file (.py or .json)
  • protocol_kind (optional): "standard" or "quick-transfer" (default: "standard")
  • key (optional): Client tracking key
  • run_time_parameters (optional): Runtime parameter values

get_protocols

List all protocols stored on the robot.

  • robot_ip (required): Robot IP address
  • protocol_kind (optional): Filter by protocol type

create_run

Create a new protocol run on the robot.

  • robot_ip (required): Robot IP address
  • protocol_id (required): ID of protocol to run
  • run_time_parameters (optional): Runtime parameter values

control_run

Control run execution (play, pause, stop, resume).

  • robot_ip (required): Robot IP address
  • run_id (required): Run ID to control
  • action (required): "play", "pause", "stop", or "resume-from-recovery"

get_runs

List all runs on the robot.

  • robot_ip (required): Robot IP address

get_run_status

Get detailed status of a specific run.

  • robot_ip (required): Robot IP address
  • run_id (required): Run ID to check

robot_health

Check robot health and connectivity.

  • robot_ip (required): Robot IP address

control_lights

Turn robot lights on or off.

  • robot_ip (required): Robot IP address
  • on (required): true to turn lights on, false to turn off

home_robot

Home robot axes or specific pipette.

  • robot_ip (required): Robot IP address
  • target (optional): "robot" for all axes, "pipette" for specific mount
  • mount (optional): "left" or "right" (required if target is "pipette")

API Reference

This tool provides access to the complete Opentrons HTTP API, including:

  • Protocol Management: Upload, analyze, and manage protocol files
  • Run Management: Create, control, and monitor protocol runs
  • Hardware Control: Robot movement, homing, lighting, and calibration
  • System Management: Health monitoring, settings, and diagnostics
  • Module Control: Temperature modules, magnetic modules, thermocyclers
  • Data Management: CSV files for runtime parameters

For detailed API documentation, use the search and documentation tools provided by this MCP server.

Related Projects