From 30edcfa5e3815f56d9bf3fedc032a10302989570 Mon Sep 17 00:00:00 2001
From: robnielsen <rob.nielsen@yahoo.com>
Date: Wed, 1 Jul 2026 00:52:53 -0500
Subject: [PATCH] [mcp] Document Antigravity CLI configuration (#21080)

Signed-off-by: Rob Nielsen <rob.nielsen@yahoo.com>
---
 bundles/org.openhab.io.mcp/README.md | 44 ++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/bundles/org.openhab.io.mcp/README.md b/bundles/org.openhab.io.mcp/README.md
index a8c7f67c17..788e06f98a 100644
--- a/bundles/org.openhab.io.mcp/README.md
+++ b/bundles/org.openhab.io.mcp/README.md
@@ -163,6 +163,50 @@ claude mcp add --transport http openhab http://openhab.local:8080/mcp \
 
 Works with both direct LAN URLs and Cloud URLs.
 
+#### Antigravity CLI (agy)
+
+Antigravity CLI configuration is stored in `~/.gemini/config/mcp_config.json`.
+
+**Option A — Direct HTTP/SSE connection:**
+
+Use the native `serverUrl` field. Works with both direct LAN URLs and Cloud URLs.
+
+```json
+{
+  "mcpServers": {
+    "openhab": {
+      "serverUrl": "http://openhab.local:8080/mcp",
+      "headers": {
+        "Authorization": "Bearer oh.YOUR_TOKEN"
+      }
+    }
+  }
+}
+```
+
+**Option B — stdio connection via `mcp-remote` bridge:**
+
+If you prefer to connect using a local stdio-to-HTTP bridge (requires Node.js 18+):
+
+```json
+{
+  "mcpServers": {
+    "openhab": {
+      "command": "npx",
+      "args": [
+        "mcp-remote@latest",
+        "http://openhab.local:8080/mcp",
+        "--allow-http",
+        "--header",
+        "Authorization: Bearer oh.YOUR_TOKEN"
+      ]
+    }
+  }
+}
+```
+
+Verify that the server is connected and view the exposed tools by typing `/mcp` inside the interactive `agy` CLI session.
+
 #### ChatGPT (chatgpt.com, desktop, mobile)
 
 ChatGPT requires a **public HTTPS URL**, so use the **openHAB Cloud** method.