diff --git a/README.md b/README.md
index 6b791cb..616b2c1 100644
--- a/README.md
+++ b/README.md
@@ -50,7 +50,7 @@ MCP client config (stdio):
 }
 ```
 
-### Docker / GHCR (streamable HTTP — for remote / metamcp wiring)
+### Docker / GHCR (streamable HTTP — for remote wiring)
 
 ```bash
 docker run -p 3900:3900 ghcr.io/cordfuse/barcoding-mcp:latest
diff --git a/docker/compose.yaml b/docker/compose.yaml
index 6ccc971..9117188 100644
--- a/docker/compose.yaml
+++ b/docker/compose.yaml
@@ -1,12 +1,15 @@
-# barcoding-mcp — the streamable-HTTP server that backs the metamcp endpoint.
+# barcoding-mcp — the streamable-HTTP server.
 #
-# Deploy / update the endpoint (pull the published image, recreate on the
-# metamcp network — this is the whole "update after a release" flow):
+# Run it:
 #   docker compose -f docker/compose.yaml pull
 #   docker compose -f docker/compose.yaml up -d
 #
 # Pin a specific version:      BARCODING_TAG=0.2.0 docker compose … up -d
 # Local dev (build from src):  docker compose -f docker/compose.yaml up -d --build
+#
+# The server listens on 127.0.0.1:3900 — point an MCP client at
+# http://localhost:3900/mcp. To let another container reach it by name, attach
+# both to a shared network (see the commented block at the bottom).
 name: barcoding-mcp
 
 services:
@@ -19,11 +22,9 @@ services:
     environment:
       PORT: "3900"
     ports:
-      # localhost-only; metamcp reaches this by container name over the shared network.
+      # localhost-only.
       - "127.0.0.1:3900:3900"
     restart: unless-stopped
-    networks:
-      - metamcp
     healthcheck:
       # node is present in the runtime image; no curl/wget needed.
       test:
@@ -36,9 +37,15 @@ services:
       retries: 3
       start_period: 10s
 
-networks:
-  # Created by the metamcp compose project; we attach so the aggregator can
-  # reach us by container name (http://barcoding-mcp:3900/mcp).
-  metamcp:
-    external: true
-    name: metamcp_metamcp-network
+# Joining an existing network (e.g. an aggregator that reaches this by container
+# name at http://barcoding-mcp:3900/mcp) — add to the service above:
+#
+#   networks:
+#     - shared
+#
+# and declare it here:
+#
+#   networks:
+#     shared:
+#       external: true
+#       name: <the-other-project>_<network>