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
+28-11Lines changed: 28 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -154,7 +154,7 @@ In summary, you can start with a broad set (everything open and discoverable) or
154
154
155
155
## Configure tools for MCP server
156
156
157
-
You can customize the tools of the MCP serverby adding query parameters to the server URL.
157
+
You can customize the MCP server’s available tools by adding query parameters to the server URL or by passing arguments to the CLI.
158
158
This allows you to enable or disable specific tool categories and control which tools are available.
159
159
160
160
The following tool categories are available:
@@ -163,26 +163,43 @@ The following tool categories are available:
163
163
-`docs` (default, can be disabled): Search Apify documentation (`search-apify-docs`) and fetch specific documents (`fetch-apify-docs`).
164
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
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`)
166
+
-`preview` (optional): Experimental tools in preview mode. Call any Actor using API (`call-actor`).
167
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.
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.
170
170
171
-
:::note Configure mcp.apify.com using query parameters
171
+
###Configure mcp.apify.com using query parameters
172
172
173
-
Use query parameter `tools` to enable or disable specific tool categories.
173
+
Use the `tools` query parameter to enable or disable specific tool categories.
174
174
175
-
For example, to enable only the `runs` and `storage` tools, you can use the URL`https://mcp.apify.com/?tools=runs,storage`
175
+
For example, to enable only the `runs` and `storage` tools, you can use:`https://mcp.apify.com/?tools=runs,storage`
176
176
177
-
This sever will expose all Actor discovery and management tools, `runs`, and `storage`.
177
+
The server will expose all `Actor discovery and management tools`, as well as `runs` and `storage`.
178
178
179
-
:::
179
+
### Configure STDIO server using CLI arguments
180
+
181
+
When running the MCP server via the command line, you can specify the tools using the `--tools` parameter.
182
+
For example, to enable only the `runs` and `storage` tools, you can run:
180
183
181
-
For STDIO use `--tools` parameter as follows `npx @apify/actors-mcp-server --tools uns,storage`.
184
+
```bash
185
+
npx @apify/actors-mcp-server --tools runs,storage
186
+
```
182
187
183
188
## Dynamic Actor tooling
184
189
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:
190
+
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.
191
+
192
+
Supported dynamic tool operations (enebled by default):
193
+
194
+
-`search-actors`: Find available Actors by keyword or category.
195
+
-`get-actor-details`: View details and usage information for a specific Actor.
196
+
-`add-actor`: Dynamically add an Actor as a tool for the current session, making it available for use.
197
+
-
198
+
These operations allow your agent to expand its toolset on demand, without requiring a server restart or manual configuration.
199
+
200
+
Dynamic tool addition can be disabled using the `?enableAddingActors=false`.
201
+
Not all MCP clients support dynamic tool addition.
202
+
Please check your client’s documentation or settings to confirm this feature is available.
0 commit comments