@apify/actors-mcp-server 0.10.10-beta.1 → 0.10.10-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +14 -17
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -106,14 +106,6 @@ Visit [mcp.apify.com](https://mcp.apify.com) to configure the server for your pr
106
106
  - [Apify Tester MCP Client](https://apify.com/jiri.spilka/tester-mcp-client) — designed for testing Apify MCP servers
107
107
 
108
108
 
109
- **Smart tool selection based on client capabilities:**
110
-
111
- When the `actors` tool category is requested, the server intelligently selects the most appropriate Actor-related tools based on the client's capabilities:
112
-
113
- - **Clients with dynamic tool support** (e.g., Claude.ai web, VS Code Genie): The server provides the `add-actor` tool instead of `call-actor`. This allows for a better user experience where users can dynamically discover and add new Actors as tools during their conversation.
114
-
115
- - **Clients with limited dynamic tool support** (e.g., Claude Desktop): The server provides the standard `call-actor` tool along with other Actor category tools, ensuring compatibility while maintaining functionality.
116
-
117
109
  # 🪄 Try Apify MCP instantly
118
110
 
119
111
  Want to try Apify MCP without any setup?
@@ -254,33 +246,38 @@ Here are some special MCP operations and how the Apify MCP Server supports them:
254
246
 
255
247
  Here is an overview list of all the tools provided by the Apify MCP Server.
256
248
 
249
+ Legend for the **Enabled by default** column:
250
+ - ✅ — in the default tool set.
251
+ - ⚡ — auto-injected when `call-actor`, `add-actor`, an Actor tool, or `get-actor-run` is present (which is true in the default configuration).
252
+
257
253
  | Tool name | Category | Description | Enabled by default |
258
254
  | :--- | :--- | :--- | :---: |
259
255
  | `search-actors` | actors | Search for Actors in Apify Store. | ✅ |
260
256
  | `fetch-actor-details` | actors | Retrieve detailed information about a specific Actor, including its input schema, README (summary when available, full otherwise), pricing, and Actor output schema. | ✅ |
261
- | `call-actor`* | actors | Call an Actor and get its run results. Use fetch-actor-details first to get the Actor's input schema. | |
262
- | `get-actor-run` | runs | Get detailed information about a specific Actor run. | |
263
- | `get-actor-output`* | - | Retrieve the output from an Actor call which is not included in the output preview of the Actor tool. | |
257
+ | `call-actor` | actors | Call an Actor and get its run results. Use fetch-actor-details first to get the Actor's input schema. | |
258
+ | `get-actor-run` | runs | Get detailed information about a specific Actor run. ||
259
+ | `get-dataset-items` | storage | Retrieve items from a dataset with support for filtering and pagination. | |
260
+ | `get-key-value-store-record`| storage | Get the value associated with a specific key in a key-value store. | ⚡ |
261
+ | `abort-actor-run` | runs | Abort a running Actor run, optionally gracefully. | ⚡ |
264
262
  | `search-apify-docs` | docs | Search the Apify documentation for relevant pages. | ✅ |
265
263
  | `fetch-apify-docs` | docs | Fetch the full content of an Apify documentation page by its URL. | ✅ |
266
264
  | [`apify--rag-web-browser`](https://apify.com/apify/rag-web-browser) | Actor (see [tool configuration](#tools-configuration)) | An Actor tool to browse the web. | ✅ |
267
265
  | `get-actor-run-list` | runs | Get a list of an Actor's runs, filterable by status. | |
268
266
  | `get-actor-log` | runs | Retrieve the logs for a specific Actor run. | |
269
267
  | `get-dataset` | storage | Get metadata about a specific dataset. | |
270
- | `get-dataset-items` | storage | Retrieve items from a dataset with support for filtering and pagination. | |
271
268
  | `get-dataset-schema` | storage | Generate a JSON schema from dataset items. | |
269
+ | `get-actor-output` | storage | Retrieve the output from an Actor call which is not included in the output preview of the Actor tool. | |
272
270
  | `get-key-value-store` | storage | Get metadata about a specific key-value store. | |
273
271
  | `get-key-value-store-keys`| storage | List the keys within a specific key-value store. | |
274
- | `get-key-value-store-record`| storage | Get the value associated with a specific key in a key-value store. | |
275
272
  | `get-dataset-list` | storage | List all available datasets for the user. | |
276
273
  | `get-key-value-store-list`| storage | List all available key-value stores for the user. | |
277
- | `add-actor`* | experimental | Add an Actor as a new tool for the user to call. ||
274
+ | `add-actor` | experimental | Add an Actor as a new tool for the user to call. | |
278
275
 
279
276
  > **Note:**
280
277
  >
281
- > 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.
278
+ > When `call-actor`, `add-actor`, an Actor tool, or `get-actor-run` is present, the server auto-injects `get-actor-run`, `get-dataset-items`, `get-key-value-store-record`, and `abort-actor-run`.
282
279
  >
283
- > The `get-actor-output` tool is automatically included with any Actor-related tool, such as `call-actor`, `add-actor`, or any specific Actor tool like `apify--rag-web-browser`. When you call an Actor - either through the `call-actor` tool or directly via an Actor tool (e.g., `apify--rag-web-browser`) - you receive a preview of the output. The preview depends on the Actor's output format and length; for some Actors and runs, it may include the entire output, while for others, only a limited version is returned to avoid overwhelming the LLM. To retrieve the full output of an Actor run, use the `get-actor-output` tool (supports limit, offset, and field filtering) with the `datasetId` provided by the Actor call.
280
+ > When you call an Actor through `call-actor` or directly via an Actor tool (e.g., `apify--rag-web-browser`) you receive a preview of the output. For long outputs the preview is truncated. To retrieve the full output, use `get-dataset-items` (auto-injected) or `get-actor-output` from the `storage` category, passing the `datasetId` returned from the call.
284
281
 
285
282
  ### Tool annotations
286
283
 
@@ -416,7 +413,7 @@ Below are realistic examples showing how an AI assistant uses the Apify MCP Serv
416
413
  The AI assistant calls the pre-configured `apify--rag-web-browser` Actor tool to search the web and return content from top results.
417
414
  The tool returns markdown content from the top 3 search results, which the AI assistant then summarizes for the user.
418
415
 
419
- ### Example 2: Discover and run an Actor from the Apify Store
416
+ ### Example 2: Discover and run an Actor from Apify Store
420
417
 
421
418
  **User prompt:**
422
419
  > Scrape the top 10 restaurants in Prague from Google Maps with their contact details.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@apify/actors-mcp-server",
3
- "version": "0.10.10-beta.1",
3
+ "version": "0.10.10-beta.2",
4
4
  "type": "module",
5
5
  "description": "Apify MCP Server",
6
6
  "mcpName": "com.apify/apify-mcp-server",