How do I install the opentrons mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

SSyncDev

Start a project

Opentrons MCP Server

MCP server for Opentrons HTTP API documentation and endpoint discovery

Local serverstdioPython

What is the Opentrons MCP Server?

MCP server for Opentrons HTTP API documentation and endpoint discovery

What the server does

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.

Credentials and setup notes

Node.js 18+ - Opentrons robot with HTTP API enabled (port 31950) - Network connectivity between client and robot

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

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.

Tool	What it does
search_endpoints
get_endpoint_details
list_by_category
get_api_overview
upload_protocol
get_protocols
create_run
control_run
get_runs
get_run_status
robot_health
control_lights
home_robot

How to install the Opentrons MCP Server

{
  "mcpServers": {
    "opentrons": {
      "command": "opentrons-mcp",
      "args": []
    }
  }
}

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

Configuration

Node.js 18+ - Opentrons robot with HTTP API enabled (port 31950) - Network connectivity between client and robot

Example prompts to try

“Use Opentrons MCP to search endpoints.”
“Use Opentrons MCP to get endpoint details.”
“Use Opentrons MCP to list by category.”

Frequently asked questions

MCP server for Opentrons HTTP API documentation and endpoint discovery Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.