Gaggiuino MCP Server

Instructions

Implementation Reference

• gaggiuino.py:81-92 (handler)

  The handler function for the getStatus tool, registered via @mcp.tool(). Fetches the espresso machine status from the API, handles fetch errors, formats the status using a helper function, and returns a human-readable string.

  @mcp.tool()
  async def getStatus() -> str:
      """Get espresso machine status.
      """
      url = f"{API_BASE}/api/system/status"
      data = await make_gg_request(url)
  
      if not data:
          return "Unable to fetch your espresso machine status."
  
      status = format_status(data[0])
      return status