diff --git a/src/docs/src/mcp.md b/src/docs/src/mcp.md
index 3ebcb63db..7656796d3 100644
--- a/src/docs/src/mcp.md
+++ b/src/docs/src/mcp.md
@@ -12,6 +12,7 @@ The Puter MCP server is hosted at [mcp.puter.com](https://mcp.puter.com). There'
 <div style="overflow:hidden; margin-top: 30px;">
     <div class="example-group active" data-section="claude-code"><span>Claude Code</span></div>
     <div class="example-group" data-section="codex"><span>Codex</span></div>
+    <div class="example-group" data-section="opencode"><span>opencode</span></div>
 </div>
 
 <div class="example-content" data-section="claude-code" style="display:block;">
@@ -38,6 +39,27 @@ You'll be sent to authenticate with Puter automatically.
 
 </div>
 
+<div class="example-content" data-section="opencode">
+
+Add Puter to the `mcp` section of your [opencode config](https://opencode.ai/docs/mcp-servers/) (`opencode.json` in your project, or `~/.config/opencode/opencode.json` globally):
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "mcp": {
+    "puter": {
+      "type": "remote",
+      "url": "https://mcp.puter.com/",
+      "enabled": true
+    }
+  }
+}
+```
+
+opencode handles the OAuth flow automatically, so it'll send you to authenticate with Puter the first time it needs access. You can re-run it anytime with `opencode mcp auth puter`.
+
+</div>
+
 <div class="info">Using a different MCP client? Point it at the HTTP endpoint <code>https://mcp.puter.com/</code>. The server uses OAuth, so your client will guide you through signing in to Puter.</div>
 
 ## Usage