From 32a462b9cde40c837c61b59897ea250a79318588 Mon Sep 17 00:00:00 2001 From: MQ37 Date: Sat, 4 Oct 2025 10:52:55 +0200 Subject: [PATCH 1/3] docs(mcp): add note regarding the dynamic tool discovery logic based on client capabilities --- sources/platform/integrations/ai/mcp.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index 2f1f9cd64..e9ce0f39b 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -264,7 +264,7 @@ This dynamic discovery means your AI can adapt to new tasks without manual confi | :--- | :--- | :--- | :--- | | `search-actors` | actors | ✅ | Search for Actors in Apify Store | | `fetch-actor-details` | actors | ✅ | Retrieve detailed information about a specific Actor | -| `call-actor` | actors | ✅ | Call an Actor and get its run results | +| `call-actor`* | actors | ❔ | Call an Actor and get its run results | | [`apify/rag-web-browser`](https://apify.com/apify/rag-web-browser) | Actor | ✅ | Browse and extract web data | | `search-apify-docs` | docs | ✅ | Search the Apify documentation for relevant pages | | `fetch-apify-docs` | docs | ✅ | Fetch the full content of an Apify documentation page by its URL | @@ -279,9 +279,15 @@ This dynamic discovery means your AI can adapt to new tasks without manual confi | `get-key-value-store-record`| storage | | Get the value associated with a specific key in a key-value store | | `get-dataset-list` | storage | | List all available datasets for the user | | `get-key-value-store-list`| storage | | List all available key-value stores for the user | -| `add-actor` | experimental | | Add an Actor as a new tool for the user to call | +| `add-actor`* | experimental | ❔ | Add an Actor as a new tool for the user to call | | `get-actor-output`* | - | Retrieve the output from an Actor call which is not included in the output preview of the Actor tool. | ✅ | +:::note Dynamic tool discovery + +When using the `actors` tool category, clients that support dynamic tool discovery (like Claude.ai web and VS Code) automatically receive the `add-actor` tool instead of `call-actor` for enhanced Actor discovery capabilities. + +::: + :::note Retrieving full output The `get-actor-output` tool is automatically included with any Actor-related tool, such as `call-actor`, `add-actor`, or specific Actor tools like `apify-slash-rag-web-browser`. When you call an Actor, you receive an output preview. Depending on the output format and length, the preview may contain the complete output or only a limited version to avoid overwhelming the LLM. To retrieve the full output, use the `get-actor-output` tool with the `datasetId` from the Actor call. This tool supports limit, offset, and field filtering. From 03296f35febc6dd111f4b6bdb295c30d86988dc8 Mon Sep 17 00:00:00 2001 From: Jiri Spilka Date: Mon, 6 Oct 2025 13:26:54 +0200 Subject: [PATCH 2/3] fix: handle review comments --- sources/platform/integrations/ai/mcp.md | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index e9ce0f39b..c9e1d8be3 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -280,20 +280,32 @@ This dynamic discovery means your AI can adapt to new tasks without manual confi | `get-dataset-list` | storage | | List all available datasets for the user | | `get-key-value-store-list`| storage | | List all available key-value stores for the user | | `add-actor`* | experimental | ❔ | Add an Actor as a new tool for the user to call | -| `get-actor-output`* | - | Retrieve the output from an Actor call which is not included in the output preview of the Actor tool. | ✅ | +| `get-actor-output`* | - | ✅ | Retrieve the output from an Actor call which is not included in the output preview of the Actor tool. | -:::note Dynamic tool discovery -When using the `actors` tool category, clients that support dynamic tool discovery (like Claude.ai web and VS Code) automatically receive the `add-actor` tool instead of `call-actor` for enhanced Actor discovery capabilities. +:::note Retrieving full output + +The `get-actor-output` tool is automatically included with any Actor-related tool, such as `call-actor`, `add-actor`, or specific Actor tools like `apify-slash-rag-web-browser`. When you call an Actor, you receive an output preview. Depending on the output format and length, the preview may contain the complete output or only a limited version to avoid overwhelming the LLM. To retrieve the full output, use the `get-actor-output` tool with the `datasetId` from the Actor call. This tool supports limit, offset, and field filtering. ::: -:::note Retrieving full output +### Dynamic tool discovery -The `get-actor-output` tool is automatically included with any Actor-related tool, such as `call-actor`, `add-actor`, or specific Actor tools like `apify-slash-rag-web-browser`. When you call an Actor, you receive an output preview. Depending on the output format and length, the preview may contain the complete output or only a limited version to avoid overwhelming the LLM. To retrieve the full output, use the `get-actor-output` tool with the `datasetId` from the Actor call. This tool supports limit, offset, and field filtering. +One of the most powerful features is the ability to discover and use new Actors on demand. +It can search Apify Store for relevant Actors using the `search-actors` tool, inspect Actor details to understand required inputs, add the Actor as a new tool, and execute it with appropriate parameters. + +This dynamic discovery means your AI can adapt to new tasks without manual configuration. +Each discovered Actor becomes immediately available for future use in the conversation. + + +:::note Dynamic tool discovery + +When you use the `actors` tool category, clients that support dynamic tool discovery (such as Claude.ai web and VS Code) will automatically receive the `add-actor` tool instead of `call-actor` for enhanced Actor discovery capabilities. +For a detailed overview of client support for dynamic discovery, see the [MCP client capabilities package](https://github.com/apify/mcp-client-capabilities). ::: + ## Advanced usage ### Production best practices From be13f96b967b56f549390231b5007d6a8ad156a3 Mon Sep 17 00:00:00 2001 From: Jiri Spilka Date: Mon, 6 Oct 2025 14:41:55 +0200 Subject: [PATCH 3/3] fix: remove dynamic tool discovery :facepalm --- sources/platform/integrations/ai/mcp.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/sources/platform/integrations/ai/mcp.md b/sources/platform/integrations/ai/mcp.md index c9e1d8be3..f16f52a96 100644 --- a/sources/platform/integrations/ai/mcp.md +++ b/sources/platform/integrations/ai/mcp.md @@ -252,12 +252,6 @@ Use the UI configurator `https://mcp.apify.com/` to select your tools visually, ::: -### Dynamic tool discovery - -One of the most powerful features is the ability to discover and use new Actors on demand. It can search Apify Store for relevant Actors using the `search-actors` tool, inspect Actor details to understand required inputs, add the Actor as a new tool, and execute it with appropriate parameters. - -This dynamic discovery means your AI can adapt to new tasks without manual configuration. Each discovered Actor becomes immediately available for future use in the conversation. - ### Available tools | Tool name | Category | Enabled by default | Description | @@ -289,7 +283,7 @@ The `get-actor-output` tool is automatically included with any Actor-related too ::: -### Dynamic tool discovery +#### Dynamic tool discovery One of the most powerful features is the ability to discover and use new Actors on demand. It can search Apify Store for relevant Actors using the `search-actors` tool, inspect Actor details to understand required inputs, add the Actor as a new tool, and execute it with appropriate parameters.