@apify/actors-mcp-server 0.10.10-beta.0 → 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.
- package/README.md +14 -17
- package/package.json +4 -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
|
|
262
|
-
| `get-actor-run` | runs | Get detailed information about a specific Actor run. |
|
|
263
|
-
| `get-
|
|
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
|
|
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
|
|
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
|
-
>
|
|
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
|
|
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.
|
|
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",
|
|
@@ -78,6 +78,7 @@
|
|
|
78
78
|
"@types/yargs-parser": "^21.0.3",
|
|
79
79
|
"eventsource": "^3.0.2",
|
|
80
80
|
"openai": "^6.10.0",
|
|
81
|
+
"oxfmt": "0.51.0",
|
|
81
82
|
"oxlint": "^1.64.0",
|
|
82
83
|
"oxlint-tsgolint": "0.22.1",
|
|
83
84
|
"p-limit": "^7.3.0",
|
|
@@ -98,6 +99,8 @@
|
|
|
98
99
|
"clean": "tsc -b src --clean && rm -rf dist/web",
|
|
99
100
|
"lint": "oxlint .",
|
|
100
101
|
"lint:fix": "oxlint . --fix",
|
|
102
|
+
"format": "oxfmt",
|
|
103
|
+
"format:check": "oxfmt --check",
|
|
101
104
|
"type-check": "tsc -p tsconfig.json --noEmit",
|
|
102
105
|
"typecheck": "pnpm run type-check",
|
|
103
106
|
"check": "pnpm run type-check && pnpm run lint",
|