chore: apply suggestions from code review

Co-authored-by: Rich Harris <[email protected]>

Author: paoloricciuti

documentation/docs/20-setup/30-remote-setup.md

@@ -38,7 +38,7 @@ To use HTTP servers in Codex you need to enable `experimental_use_rmcp_client` a
 
 ## Gemini CLI
 
-To include the remote MCP version in Gemini CLI, simply run the following command:
+To use the remote MCP server with Gemini CLI, simply run the following command:
 
 ```bash
 gemini mcp add -t http -s [scope] svelte https://mcp.svelte.dev/mcp

documentation/docs/30-capabilities/10-tools.md

@@ -2,20 +2,20 @@
 title: Tools
 ---
 
-This is the list of available tools provided by the MCP server. The list of tools is given to the model which can decide to call one or more of the tools during a session.
+The following tools are provided by the MCP server to the model, which can decide to call one or more of them during a session:
 
 ## list-sections
 
-Provides a list of all the available documentation sections and their use cases if available. The titles of the sections will be used by the LLM to get up-to-date documentation directly from the official documentation.
+Provides a list of all the available documentation sections.
 
 ## get-documentation
 
-Allows the model to get the full documentation for the requested sections. The documentation is fetched on the fly from the official Svelte documentation and it will always be up to date.
+Allows the model to get the full (and up-to-date) documentation for the requested sections directly from [svelte.dev/docs](/docs).
 
 ## svelte-autofixer
 
 Uses static analysis to provide suggestions for the generated code. It should be invoked in a loop by the model until all issues and suggestions are resolved.
 
 ## playground-link
 
-Generates an ephemeral playground link with the generated code. It's useful when the generated code is not written to a file in your project and you want to quickly test the generated solution. The code is not stored anywhere, the server uses the `share-with-hash` functionality of the Svelte playground to generate the correct hash on the fly (which is also why it will generate a pretty big link).
+Generates an ephemeral playground link with the generated code. It's useful when the generated code is not written to a file in your project and you want to quickly test the generated solution. The code is not stored anywhere except the URL itself (which will often, as a consequence, be quite large).