diff --git a/.cursor/mcp.json b/.cursor/mcp.json
new file mode 100644
index 0000000..b8ec638
--- /dev/null
+++ b/.cursor/mcp.json
@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "wormhole-docs": {
+      "command": "node",
+      "args": ["./mcp-wormhole-docs/index.js"],
+      "cwd": "${workspaceFolder}"
+    }
+  }
+}
diff --git a/docs/04-configuration/MCP_SETUP.md b/docs/04-configuration/MCP_SETUP.md
index 3122590..2fb0821 100644
--- a/docs/04-configuration/MCP_SETUP.md
+++ b/docs/04-configuration/MCP_SETUP.md
@@ -202,7 +202,15 @@ cd /home/intlc/projects/proxmox/mcp-wormhole-docs && pnpm install
 
 **Tools:** `wormhole_doc_search` with `{ "query": "NTT", "limit": 10 }`.
 
-**Manual smoke test** (from repo root, after `pnpm install` in `mcp-wormhole-docs`):
+**Cursor (this repo):** Project MCP config is [`.cursor/mcp.json`](../../.cursor/mcp.json) — server id **`wormhole-docs`**. After pulling changes: **Cursor Settings → MCP** (or **Tools & MCP**) should list it; if not, **reload the window** or restart Cursor. One-shot from repo root: `pnpm run mcp:wormhole` (stdio server; Cursor spawns it automatically when MCP is enabled).
+
+**Health check (no MCP client):**
+
+```bash
+pnpm run verify:wormhole-mcp
+```
+
+**Manual smoke test** (from repo root, after `pnpm install` at workspace root or in `mcp-wormhole-docs`):
 
 ```bash
 cd /home/intlc/projects/proxmox/mcp-wormhole-docs && node index.js
diff --git a/mcp-wormhole-docs/README.md b/mcp-wormhole-docs/README.md
index 58469ba..3d1ad3f 100644
--- a/mcp-wormhole-docs/README.md
+++ b/mcp-wormhole-docs/README.md
@@ -14,6 +14,10 @@ Read-only MCP server exposing Wormhole’s **AI documentation exports** as **res
 | `WORMHOLE_DOCS_FETCH` | `0` | If `1`, fall back to HTTPS from `https://wormhole.com/docs/...` when a file is missing locally |
 | `WORMHOLE_MAX_RESOURCE_BYTES` | `5242880` | Max bytes returned for `llms-full.jsonl` via MCP read (avoid OOM); increase or read file on disk for RAG |
 
+## Cursor
+
+Repo file [`.cursor/mcp.json`](../.cursor/mcp.json) registers this server as **`wormhole-docs`**. Enable MCP in Cursor; reload if the server does not appear. From repo root: `pnpm run verify:wormhole-mcp` then `pnpm run mcp:wormhole` (manual stdio test only).
+
 ## Run
 
 ```bash
diff --git a/package.json b/package.json
index 560ca00..f66c4ac 100644
--- a/package.json
+++ b/package.json
@@ -6,6 +6,8 @@
   "scripts": {
     "mcp:start": "pnpm --filter mcp-proxmox-server start",
     "mcp:dev": "pnpm --filter mcp-proxmox-server dev",
+    "mcp:wormhole": "node mcp-wormhole-docs/index.js",
+    "verify:wormhole-mcp": "bash scripts/verify/verify-wormhole-ai-docs-setup.sh",
     "omada:build": "pnpm --filter omada-api build && pnpm --filter mcp-omada-server build",
     "omada:start": "pnpm --filter mcp-omada-server start",
     "omada:dev": "pnpm --filter mcp-omada-server dev",