feat: Improve description for MCP server tools configuration

sources/platform/integrations/ai/langflow.md

@@ -70,7 +70,9 @@ To call Apify Actors in Langflow, we need to add the **Apify Actors** component
 From the bundle menu, add **Apify Actors** component:
 ![Flow - Add Apify Actors](../images/langflow/bundles_apify.png)
 
-Next, we need to configure the Apify Actors components. First, input your API token (learn how to get it [here](https://docs.apify.com/platform/integrations/api)). Then, set the Actor ID of the component to `apify/rag-web-browser` to use the [RAG Web Browser](https://apify.com/apify/rag-web-browser). Set the **Run input** field to pass arguments to the Actor run, allowing it to search Google with the query `"what is monero?"` (full Actor input schema can be found [here](https://apify.com/apify/rag-web-browser/input-schema)):
+Next, we need to configure the Apify Actors components. First, input your API token (learn how to get it at [Integrations](https://docs.apify.com/platform/integrations/api)).
+Then, set the Actor ID of the component to `apify/rag-web-browser` to use the [RAG Web Browser](https://apify.com/apify/rag-web-browser).
+Set the **Run input** field to pass arguments to the Actor run, allowing it to search Google with the query `"what is monero?"` (full Actor input schema can be found in the [RAG Web Browser input schema](https://apify.com/apify/rag-web-browser/input-schema)):
 
 ```json
 {"query": "what is monero?", "maxResults": 3}
@@ -100,10 +102,10 @@ Now that we understand how to call Apify Actors, let's build a practical example
 
 Create a new flow and add two **Apify Actors** components from the menu.
 
-Input your API token (learn how to get it [here](https://docs.apify.com/platform/integrations/api)) and set the Actor ID of the first component to `apify/google-search-scraper` and the second one to `clockworks/free-tiktok-scraper`:
+Input your API token (learn how to get it in the [Integrations documentation](https://docs.apify.com/platform/integrations/api)) and set the Actor ID of the first component to `apify/google-search-scraper` and the second one to `clockworks/free-tiktok-scraper`:
 ![Flow - Actors configuration](../images/langflow/apify_actors_configuration.png)
 
-Add the **Agent** component from the menu and set your OpenAI API key (get it [here](https://platform.openai.com/account/api-keys)):
+Add the **Agent** component from the menu and set your OpenAI API key (get it from the [OpenAI API keys page](https://platform.openai.com/account/api-keys)):
 
 :::tip Optimize Agent results
 

sources/platform/integrations/ai/mcp.md

@@ -152,27 +152,58 @@ By default, the main Actors MCP Server starts with a single default [RAG Web Bro
 
 In summary, you can start with a broad set (everything open and discoverable) or a narrow set (just what you need) and even expand tools on the fly, giving your agent a lot of flexibility without overwhelming it initially.
 
-## Dynamic Actor tooling
+## Configure tools for MCP server
 
-One of the powerful features of MCP with Apify is **dynamic Actor tooling** – the ability for an AI agent to find new tools (Actors) as needed and incorporate them. Here are some special MCP operations and how Apify MCP Server supports them:
+You can customize the MCP server’s available tools by adding query parameters to the server URL or by passing arguments to the CLI.
+This allows you to enable or disable specific tool categories and control which tools are available.
 
-- _Actor discovery and management:_ Search for [Actors](https://docs.apify.com/platform/actors) (`search-actors`), view details (`get-actor-details`), and dynamically add them (`add-actor`).
-- _Apify documentation:_ Search Apify documentation (`search-apify-docs`) and fetch specific documents (`fetch-apify-docs`).
-- _Actor runs (*):_ Get a list of your [Actor runs](https://docs.apify.com/platform/actors/running/runs-and-builds#runs) (`get-actor-run-list`), specific run details (`get-actor-run`), and logs from a specific Actor run (`get-actor-log`).
-- _Apify storage (*):_ Access [datasets](https://docs.apify.com/platform/storage/dataset)(`get-dataset`, `get-dataset-items`, `get-dataset-list`), [key-value stores](https://docs.apify.com/platform/storage/key-value-store) (`get-key-value-store`, `get-key-value-store-keys`, `get-key-value-store-record`, `get-key-value-store-records`), and their records.
+The following tool categories are available:
 
-:::note Optional tools
+- _Actor discovery and management_ (default, always enabled): Search for [Actors](https://docs.apify.com/platform/actors) (`search-actors`), view details (`get-actor-details`), and dynamically add them (`add-actor`).
+- _docs_ (default, can be disabled): Search Apify documentation (`search-apify-docs`) and fetch specific documents (`fetch-apify-docs`).
+- _runs_ (optional): Get a list of your [Actor runs](https://docs.apify.com/platform/actors/running/runs-and-builds#runs) (`get-actor-run-list`), specific run details (`get-actor-run`), and logs from a specific Actor run (`get-actor-log`).
+- _storage_ (optional): Access [datasets](https://docs.apify.com/platform/storage/dataset) and [key-value stores](https://docs.apify.com/platform/storage/key-value-store), including their records (`get-dataset`, `get-dataset-items`, `get-dataset-list`, `get-key-value-store`, `get-key-value-store-keys`, `get-key-value-store-record`, `get-key-value-store-records`).
+- _preview_ (optional): Experimental tools in preview mode. Call any Actor using API (`call-actor`).
 
-Helper tool categories marked with (*) are not enabled by default in the MCP server and must be explicitly enabled using the `tools` argument (either the `--tools` command line argument for the stdio server or the `?tools` URL query parameter for the remote MCP server). The `tools` argument is a comma-separated list of categories with the following possible values:
+The _Actor discovery and management_ tools are always present and cannot be disabled.
+The _docs_ tools are enabled by default but can be switched off using the `tools` parameter.
 
-- `docs`: Search and fetch Apify documentation.
-- `runs`: Get Actor runs list, run details, and logs from a specific Actor run.
-- `storage`: Access datasets, key-value stores, and their records.
-- `preview`: Experimental tools in preview mode.
+### Configure mcp.apify.com using query parameters
 
-:::
+Use the `tools` query parameter to enable or disable specific tool categories.
+
+For example, to enable only the `runs` and `storage` tools, you can use:
+
+```text
+https://mcp.apify.com/?tools=runs,storage
+```
+
+The server will expose all `Actor discovery and management tools`, as well as `runs` and `storage`.
+
+### Configure STDIO server using CLI arguments
+
+When running the MCP server via the command line, you can specify the tools using the `--tools` parameter.
+For example, to enable only the `runs` and `storage` tools, you can run:
+
+```bash
+npx @apify/actors-mcp-server --tools runs,storage
+```
+
+## Dynamic Actor tooling
+
+One of the powerful features of MCP with Apify is **dynamic Actor tooling** – the ability for an AI agent to find new tools (Actors) as needed and incorporate them.
+
+Supported dynamic tool operations (enebled by default):
+
+- `search-actors`: Find available Actors by keyword or category.
+- `get-actor-details`: View details and usage information for a specific Actor.
+- `add-actor`: Dynamically add an Actor as a tool for the current session, making it available for use.
+
+These operations allow your agent to expand its toolset on demand, without requiring a server restart or manual configuration.
 
-For example, to enable all tools, use `npx @apify/actors-mcp-server --tools docs,runs,storage,preview` or `https://mcp.apify.com/?tools=docs,runs,storage,preview`.
+Dynamic tool addition can be disabled using the `?enableAddingActors=false`.
+Not all MCP clients support dynamic tool addition.
+Please check your client’s documentation or settings to confirm this feature is available.
 
 ## Rate limits