Sartorius Balance — MCP Server

Let an AI agent weigh samples, tare containers, log drift and evaporation, and run internal adjustments on Sartorius laboratory balances through the documented SBI (Sartorius Balance Interface) ASCII protocol.

Try it without hardware

uvx labmcp-sartorius --simulate --check

Connect your balance

1. Balance setup: set the interface you use (RS232, USB-B / "PC-SBI", or Ethernet) to the SBI protocol, and set SBI data output to manual, without stability with automatic output off (factory settings on Cubis II and Entris II). With auto print on, ESC P toggles the automatic output instead of sending one reading. Either line format works (16 characters, or 22 with ID code).
2. Serial settings: factory settings are 9600 baud, 8 data bits, odd parity, 1 stop bit, hardware handshake (Cubis II/MSE, Secura/Quintix/Practum, Entris II). The server uses these but does not enforce RTS/CTS (it keeps RTS asserted, which lets the balance transmit; USB virtual COM ports often never assert CTS). Add ?rtscts=true to enforce it, or e.g. ?bytesize=7&parity=E if your balance is set differently.
3. Find the port: uvx labmcp ports
4. Test the connection:

   uvx labmcp-sartorius --address /dev/ttyUSB0 --check                 # Linux
   uvx labmcp-sartorius --address /dev/tty.usbmodem14201 --check       # macOS
   uvx labmcp-sartorius --address COM4 --check                         # Windows
   uvx labmcp-sartorius --address tcp://192.168.1.61:49155 --check     # Cubis II via Ethernet (port as configured)
   

   --check prints the model, serial number and software version (ESC x1_, x2_, x3_) when the balance supports them.

Add to your MCP client

Claude Code

claude mcp add balance -- uvx labmcp-sartorius --address /dev/ttyUSB0

Claude Desktop / Cursor / Windsurf (claude_desktop_config.json, .cursor/mcp.json, …)

{
  "mcpServers": {
    "balance": {
      "command": "uvx",
      "args": ["labmcp-sartorius", "--address", "/dev/ttyUSB0"]
    }
  }
}

Add --read-only to allow weighing but block taring, zeroing and adjustment. For other clients: uvx labmcp config sartorius-balance --address /dev/ttyUSB0 --client vscode.

Tools

Safety limits

Override at launch: --limit max_series_duration_s=3600. Whatever the limit says, a single series is capped at one hour (the tool's time limit). No tool of this server moves anything or heats, so there are no hazard tools.

Example prompts

• "Tare the balance, then tell me the weight once it's stable after I add the sample."
• "Log the weight every 10 s for 5 minutes and tell me the evaporation rate in mg/min."
• "Weigh out ~250 mg: tell me how much more to add, reading every few seconds, until I'm within ±2 mg."
• "The bench is vibrating today; switch the balance filter to unstable conditions and lock the keypad."
• "Run an internal adjustment before we start the calibration curve and tell me whether it ran."

Notes

• Stability comes from the unit symbol. SBI has no explicit stability flag: the balance only sends the unit symbol (positions 12–14) when the reading is stable ("If the weighing system has not stabilized, no unit symbol is output", interface description 98647-000-53; the newer manuals list those positions as "unit symbol or space"). read_weight(stable=true) therefore polls ESC P until a reading with a unit arrives. Unstable readings report the last unit seen.
• Line formats. The parser follows the documented fixed-width layouts: 16 characters (sign, value in positions 2–10, unit in 12–14, CR LF) and 22 characters (6-character ID code such as N, G#, T, Stat, then the same 16). It also accepts the Cubis II "one line with full length" format, a decimal comma, and a G#/T/N weighing block (the N line is reported). High, Low, Err ###, APP.ERR, DIS.ERR and PRT.ERR are reported as clear errors.
• No acknowledgements. SBI control commands (ESC U tare, ESC V zero, ESC Z adjust, ESC K–N filter, ESC O/R keys) produce no reply, so a balance that does not support one silently ignores it. tare and zero therefore wait for a stable reading and check it is ~0, and report an error otherwise.
• Zero vs tare. ESC V only zeroes within the balance's zero-setting range (nearly empty pan); ESC U tares any load. Older balances (CP/CPA, LE, ...) only have ESC T (the tare key): start the server with --option legacy=true.
• Internal adjustment (unverified). ESC Z starts isoCAL on balances with a built-in weight. SBI sends no completion or result message; the server watches for the Cal. status (or a balance too busy to answer) and waits for a stable weight again, and reports observed_adjustment=false if it never sees one. Confirm the result on the display or GLP printout. The exact status output during adjustment could not be verified in the manuals.
• Identity replies (unverified format). ESC x1_/x2_/x3_ print the model, serial number and software version; their exact layout is not documented, so the text is passed through as sent.
• The command log shows SBI traffic as hex (1b 50 0d 0a = ESC P CR LF) because of the ESC character.
• Not implemented: draft-shield and ionizer commands (Cubis MSE only), external adjustment (ESC W, needs a reference weight), ESC S restart and the function-key commands.

Hardware verification