diff --git a/.github/workflows/npm-build-publish.yml b/.github/workflows/npm-build-publish.yml
index c9841e0..4a185af 100644
--- a/.github/workflows/npm-build-publish.yml
+++ b/.github/workflows/npm-build-publish.yml
@@ -263,6 +263,9 @@ jobs:
             done
           done
 
+      - name: Copy README into hyperdb-mcp npm publish directory
+        run: cp hyperdb-mcp/README.md hyperdb-mcp/npm/README.md
+
       - name: Determine npm dist-tag
         id: dist-tag
         run: |
diff --git a/hyperdb-mcp/npm/package.json b/hyperdb-mcp/npm/package.json
index ed94a4c..52988a1 100644
--- a/hyperdb-mcp/npm/package.json
+++ b/hyperdb-mcp/npm/package.json
@@ -11,7 +11,8 @@
     "hyperdb-mcp-win32-x64-msvc": "0.1.1"
   },
   "files": [
-    "bin.js"
+    "bin.js",
+    "README.md"
   ],
   "keywords": [
     "hyper",