diff --git a/docs/start/getting-started.md b/docs/start/getting-started.md
index 8ffcdb80a..f94821237 100644
--- a/docs/start/getting-started.md
+++ b/docs/start/getting-started.md
@@ -40,6 +40,8 @@ run on host, set an explicit per-agent override:
 
 - Node `>=22`
 - `pnpm` (optional; recommended if you build from source)
+- **Recommended:** Brave Search API key for web search. Set `BRAVE_API_KEY` or
+  `tools.web.search.apiKey`. See [Web tools](/tools/web).
 
 macOS: if you plan to build the apps, install Xcode / CLT. For the CLI + gateway only, Node is enough.
 Windows: use **WSL2** (Ubuntu recommended). WSL2 is strongly recommended; native Windows is untested and more problematic. Install WSL2 first, then run the Linux steps inside WSL. See [Windows (WSL2)](/platforms/windows).