diff --git a/README.md b/README.md
index 2201147..a08c33a 100644
--- a/README.md
+++ b/README.md
@@ -63,6 +63,23 @@ npm run roadmap:dev          # roadmap (VitePress)
 npm run community-token:dev  # community token mini-site
 ```
 
+### Local dev ports (fixed defaults)
+
+Run several targets at once — each command owns one port. Override only when needed (`PORT=…` on Vite apps).
+
+| Port | Command / repo | Site or tool |
+| --- | --- | --- |
+| 5173 | `website`: `npm run dev` | Explorations (Vite default) |
+| 5174 | `website`: `npm run community-token:dev` | Community token |
+| 5175 | `website`: `npm run social:dev` | Roadmap social card preview (may pick next free port) |
+| 5176 | `website`: `npm run docs:dev` | Docs hub landing |
+| 5177 | `mcp-gateway`: `npm run metrics-ui:dev` | MCP usage dashboard (dummy fixtures) |
+| 3000 | `mcp-gateway`: `npm run start:http` | MCP HTTP lab |
+| 3001 | `mcp-gateway`: `npm run start:metrics` | Metrics read API + built UI |
+| 4173 | `website`: Cypress E2E | Explorations preview (CI), not daily dev |
+
+VitePress dev servers (`website-docs`, `mcp-docs`, `roadmap`) use their own defaults — see each folder’s README.
+
 ### Build & deploy
 
 ```bash
diff --git a/vite.community-token.config.ts b/vite.community-token.config.ts
index 6a19c3a..74fb596 100644
--- a/vite.community-token.config.ts
+++ b/vite.community-token.config.ts
@@ -7,7 +7,7 @@ const rootDir = fileURLToPath(new URL('./community-token', import.meta.url))
 const outDir = fileURLToPath(new URL('./dist/community-token', import.meta.url))
 
 // Standalone mini-site for community-token.feelyourprotocol.org
-// Dev:  npm run community-token:dev   (http://localhost:5174)
+// Dev:  npm run community-token:dev   (http://localhost:5174 — not mcp-gateway metrics-ui)
 // Prod: npm run community-token:build → dist/community-token/
 export default defineConfig({
   root: rootDir,