diff --git a/zcode-acp/agent.json b/zcode-acp/agent.json
new file mode 100644
index 000000000..8e5c40f38
--- /dev/null
+++ b/zcode-acp/agent.json
@@ -0,0 +1,16 @@
+{
+  "id": "zcode-acp",
+  "name": "ZCode ACP",
+  "version": "0.17.1",
+  "description": "Community bridge that drives the real ZCode app-server (GLM) over ACP — the full official harness in Zed and JetBrains, no editor-side API keys.",
+  "repository": "https://github.com/william0wang/zcode-acp",
+  "website": "https://github.com/william0wang/zcode-acp",
+  "authors": ["William Wang"],
+  "license": "Apache-2.0",
+  "icon": "icon.svg",
+  "distribution": {
+    "npx": {
+      "package": "zcode-acp-server@0.17.1"
+    }
+  }
+}
diff --git a/zcode-acp/icon.svg b/zcode-acp/icon.svg
new file mode 100644
index 000000000..1a012dab9
--- /dev/null
+++ b/zcode-acp/icon.svg
@@ -0,0 +1,4 @@
+<svg width="16" height="16" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg">
+  <rect width="16" height="16" rx="3" fill="none" stroke="currentColor" stroke-width="1.5"/>
+  <path d="M4.5 4.5 H11.5 L4.8 11 H11.5" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>