diff --git a/docs/features/acp/index.md b/docs/features/acp/index.md
index 7e9960cc3..b19b6a61d 100644
--- a/docs/features/acp/index.md
+++ b/docs/features/acp/index.md
@@ -77,7 +77,7 @@ A host application would spawn docker-agent as a subprocess and communicate via
 
 ```javascript
 // Pseudocode for an IDE extension
-const child = spawn("docker", "agent", "serve", ["acp", "./agent.yaml"]);
+const child = spawn("docker", ["agent", "serve", "acp", "./agent.yaml"]);
 
 // Send a message to the agent
 child.stdin.write(
diff --git a/docs/features/mcp-mode/index.md b/docs/features/mcp-mode/index.md
index 825bded6f..f9099120a 100644
--- a/docs/features/mcp-mode/index.md
+++ b/docs/features/mcp-mode/index.md
@@ -50,7 +50,8 @@ Add a configuration to your Claude Desktop MCP settings file:
     "myagent": {
       "command": "/usr/local/bin/docker",
       "args": [
-        "agent"
+        "agent", 
+        "serve",
         "mcp",
         "agentcatalog/coder",
         "--working-dir",