diff --git a/CHANGELOG.md b/CHANGELOG.md
index 388110b9..274d131f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -17,7 +17,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   the CPU, without a warning; `"cpu"` keeps them on the CPU; `"metal"` raises when
   the GPU cannot run the circuit. `TSIM_DEVICE=cpu` keeps `"auto"` on the CPU, and
   `SamplerStats.device` and the repr say where they sample.
-- The docs pages have a menu to copy a page or open it in ChatGPT or Claude, and
+- The docs pages have a menu to copy a page, open it in ChatGPT or Claude, or add
+  the docs MCP server to Cursor or VS Code, and
   the README, the install page and the agent skill point to the docs MCP server
   at `https://bloqade.quera.com/tsim/mcp`. The README and the install page also
   show how to install the agent skill with Ion.
diff --git a/docs/docs.json b/docs/docs.json
index 604937ae..1c6e74ac 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -9,7 +9,30 @@
   },
   "favicon": "/images/favicon.svg",
   "contextual": {
-    "options": ["copy", "view", "chatgpt", "claude", "mcp", "cursor", "vscode"]
+    "options": [
+      "copy",
+      "view",
+      "chatgpt",
+      "claude",
+      {
+        "title": "MCP server",
+        "description": "Connect an agent to the docs MCP server",
+        "icon": "plug",
+        "href": "https://bloqade.quera.com/tsim/install#docs-mcp-server"
+      },
+      {
+        "title": "Connect to Cursor",
+        "description": "Install the docs MCP server in Cursor",
+        "icon": "arrow-pointer",
+        "href": "cursor://anysphere.cursor-deeplink/mcp/install?name=Tsim&config=eyJ1cmwiOiJodHRwczovL2Jsb3FhZGUucXVlcmEuY29tL3RzaW0vbWNwIn0%3D"
+      },
+      {
+        "title": "Connect to VS Code",
+        "description": "Install the docs MCP server in VS Code",
+        "icon": "code",
+        "href": "vscode:mcp/install?%7B%22name%22%3A%22Tsim%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fbloqade.quera.com%2Ftsim%2Fmcp%22%7D"
+      }
+    ]
   },
   "seo": {
     "metatags": {
diff --git a/docs/install.mdx b/docs/install.mdx
index f452828a..48d693c5 100644
--- a/docs/install.mdx
+++ b/docs/install.mdx
@@ -107,7 +107,18 @@ and read these docs. Add it to Claude Code with:
 claude mcp add --transport http tsim https://bloqade.quera.com/tsim/mcp
 ```
 
-For Cursor and VS Code, use the page menu at the top of any page.
+For Cursor and VS Code, use the page menu at the top of any page, or add the server by hand,
+for Cursor in `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "Tsim": {
+      "url": "https://bloqade.quera.com/tsim/mcp"
+    }
+  }
+}
+```
 
 ## Development setup