RoastPilot
Controls coffee roasting hardware through local stdio MCP tools. Built around home coffee roaster automation, it exposes tools for starting roast sessions, adjusting heat and fan levels, reading telemetry from bean and environment temperatures, marking first crack events, dropping beans, and exporting session logs to JSONL and CSV. The default mock driver lets you test the full roast workflow without hardware. Production mode integrates with Hottop roasters and includes optional audio-based first crack detection using a Hugging Face model. Reach for this if you're building autonomous or AI-assisted roasting workflows and need programmatic control over the roast profile, timing markers, and structured log output.
- tools
- 15
- transport
- STDIO
- last updated
- Oct 13, 2026
Tools
15 toolsPublic tool metadata for what this MCP can expose to an agent.
get_server_info
No parameter schema in public metadata yet.
get_runtime_config
No parameter schema in public metadata yet.
start_roast_sessionCreates the one active roast session and connects the configured driver.
Creates the one active roast session and connects the configured driver.
No parameter schema in public metadata yet.
get_roast_stateReads the authoritative session state and the current configured-device state.
Reads the authoritative session state and the current configured-device state.
No parameter schema in public metadata yet.
set_heatSets heat through the configured RoasterDriver boundary.
Sets heat through the configured RoasterDriver boundary.
No parameter schema in public metadata yet.
set_fanSets fan through the configured RoasterDriver boundary.
Sets fan through the configured RoasterDriver boundary.
No parameter schema in public metadata yet.
mark_beans_addedExplicit override tool for recording bean addition during operator recovery or controlled manual runs.
Explicit override tool for recording bean addition during operator recovery or controlled manual runs.
No parameter schema in public metadata yet.
mark_first_crackExplicit override tool for recording first crack during operator recovery or controlled manual runs.
Explicit override tool for recording first crack during operator recovery or controlled manual runs.
No parameter schema in public metadata yet.
drop_beansThe normal drop command; records bean drop, turns heat off, sets fan to 100%, and enters the cooling phase.
The normal drop command; records bean drop, turns heat off, sets fan to 100%, and enters the cooling phase.
No parameter schema in public metadata yet.
start_coolingExplicit advanced/manual recovery tool for starting cooling.
Explicit advanced/manual recovery tool for starting cooling.
No parameter schema in public metadata yet.
stop_coolingStops cooling when cooling is complete.
Stops cooling when cooling is complete.
No parameter schema in public metadata yet.
export_roast_log
No parameter schema in public metadata yet.
emergency_stop
No parameter schema in public metadata yet.
set_recording_metadata
No parameter schema in public metadata yet.
finalise_cold_characterisation_session
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
RoastPilot
RoastPilot is an MCP server for coffee-roaster telemetry and controlled actuation.
The package name is coffee-roaster-mcp. It is published on production PyPI
and listed in the MCP Registry as
io.github.syamaner/coffee-roaster-mcp.
RoastPilot provides one local MCP runtime for roaster control, telemetry, first-crack detection integration, roast metrics, and log export.
Status
✅ v0.1 component scope complete, published on PyPI and in the MCP Registry, and exercised in supervised agent-controlled hardware roasts through 2026-08-16.
The latest integrated evidence is two completed Hottop roasts on 2026-08-16.
Together they exercised live telemetry and control, automatic T0, first-crack
handling, post-first-crack decisions, safety evaluation, advisor-triggered
drop, operator-controlled cooling completion, ambient sensing, log export, and
paired-microphone capture. The agent ledger recorded 19 successful advisor
decisions, each linked to an allow safety evaluation; both advisor-proposed
drops were executed, with no failed command events or safety alerts in either
completed run.
Details
- Repository
- github.com/syamaner/coffee-roaster-mcp
- Website
- github.com/syamaner/coffee-roaster-mcp#readme
- Package
coffee-roaster-mcp- Transport
- STDIO
- Registry
- MCP registry, active