You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: sources/platform/integrations/ai/mcp.md
+23-13Lines changed: 23 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -152,27 +152,37 @@ By default, the main Actors MCP Server starts with a single default [RAG Web Bro
152
152
153
153
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.
154
154
155
-
## Dynamic Actor tooling
155
+
## Configure tools for MCP server
156
156
157
-
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:
157
+
You can customize the tools of the MCP server by adding query parameters to the server URL.
158
+
This allows you to enable or disable specific tool categories and control which tools are available.
159
+
160
+
The following tool categories are available:
161
+
162
+
-`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`).
163
+
-`docs` (default, can be disabled): Search Apify documentation (`search-apify-docs`) and fetch specific documents (`fetch-apify-docs`).
164
+
-`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`).
165
+
-`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`).
166
+
-`preview` (optional): Experimental tools in preview mode. Call any Actor using API (`call-actor`)
167
+
168
+
The "Actor discovery and management" tools are always present and cannot be disabled.
169
+
The "docs" tools are enabled by default but can be switched off using the `tools` parameter.
158
170
159
-
-_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`).
160
-
-_Apify documentation:_ Search Apify documentation (`search-apify-docs`) and fetch specific documents (`fetch-apify-docs`).
161
-
-_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`).
162
-
-_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.
171
+
:::note Configure mcp.apify.com using query parameters
163
172
164
-
:::note Optional tools
173
+
Use query parameter `tools` to enable or disable specific tool categories.
165
174
166
-
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:
175
+
For example, to enable only the `runs`and `storage`tools, you can use the URL `https://mcp.apify.com/?tools=runs,storage`
167
176
168
-
-`docs`: Search and fetch Apify documentation.
169
-
-`runs`: Get Actor runs list, run details, and logs from a specific Actor run.
170
-
-`storage`: Access datasets, key-value stores, and their records.
171
-
-`preview`: Experimental tools in preview mode.
177
+
This sever will expose all Actor discovery and management tools, `runs`, and `storage`.
172
178
173
179
:::
174
180
175
-
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`.
181
+
For STDIO use `--tools` parameter as follows `npx @apify/actors-mcp-server --tools uns,storage`.
182
+
183
+
## Dynamic Actor tooling
184
+
185
+
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:
0 commit comments