From ed51361511b6210b2c62c7254bba413dc1073b8c Mon Sep 17 00:00:00 2001
From: Olivier Chafik <ochafik@anthropic.com>
Date: Fri, 16 Jan 2026 14:31:42 +0000
Subject: [PATCH] docs: add combined MCP client config to top-level README

Add a collapsible details section with configuration for all example
servers in the Examples section of the main README.
---
 README.md | 96 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 96 insertions(+)

diff --git a/README.md b/README.md
index 6057fe1..5be1f12 100644
--- a/README.md
+++ b/README.md
@@ -79,6 +79,102 @@ Or edit your `package.json` manually:
 
 The [`examples/`](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples) directory contains additional demo apps showcasing real-world use cases.
 
+<details>
+<summary>MCP client configuration for all examples</summary>
+
+Add to your MCP client configuration (stdio transport):
+
+```json
+{
+  "mcpServers": {
+    "basic-react": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-basic-react", "--stdio"]
+    },
+    "basic-vanillajs": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-basic-vanillajs", "--stdio"]
+    },
+    "basic-vue": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-basic-vue", "--stdio"]
+    },
+    "basic-svelte": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-basic-svelte", "--stdio"]
+    },
+    "basic-preact": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-basic-preact", "--stdio"]
+    },
+    "basic-solid": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-basic-solid", "--stdio"]
+    },
+    "budget-allocator": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-budget-allocator", "--stdio"]
+    },
+    "cohort-heatmap": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-cohort-heatmap", "--stdio"]
+    },
+    "customer-segmentation": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-customer-segmentation", "--stdio"]
+    },
+    "map": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-map", "--stdio"]
+    },
+    "pdf": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-pdf", "--stdio"]
+    },
+    "scenario-modeler": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-scenario-modeler", "--stdio"]
+    },
+    "shadertoy": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-shadertoy", "--stdio"]
+    },
+    "sheet-music": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-sheet-music", "--stdio"]
+    },
+    "system-monitor": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-system-monitor", "--stdio"]
+    },
+    "threejs": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-threejs", "--stdio"]
+    },
+    "transcript": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-transcript", "--stdio"]
+    },
+    "video-resource": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-video-resource", "--stdio"]
+    },
+    "wiki-explorer": {
+      "command": "npx",
+      "args": ["-y", "--silent", "--registry=https://registry.npmjs.org/", "@modelcontextprotocol/server-wiki-explorer", "--stdio"]
+    },
+    "qr": {
+      "command": "uv",
+      "args": ["run", "/path/to/ext-apps/examples/qr-server/server.py", "--stdio"]
+    }
+  }
+}
+```
+
+> **Note:** The `qr` server requires cloning the repository first. See [qr-server README](examples/qr-server) for details.
+
+</details>
+
 To run all examples:
 
 ```bash