Skip to content

Commit 85506f3

Browse files
committed
feat: Update configuration params
1 parent a1561e8 commit 85506f3

File tree

1 file changed

+28
-11
lines changed
  • sources/platform/integrations/ai

1 file changed

+28
-11
lines changed

sources/platform/integrations/ai/mcp.md

Lines changed: 28 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ In summary, you can start with a broad set (everything open and discoverable) or
154154

155155
## Configure tools for MCP server
156156

157-
You can customize the tools of the MCP server by 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.
158158
This allows you to enable or disable specific tool categories and control which tools are available.
159159

160160
The following tool categories are available:
@@ -163,26 +163,43 @@ The following tool categories are available:
163163
- `docs` (default, can be disabled): Search Apify documentation (`search-apify-docs`) and fetch specific documents (`fetch-apify-docs`).
164164
- `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`).
165165
- `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`).
167167

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.
170170

171-
:::note Configure mcp.apify.com using query parameters
171+
### Configure mcp.apify.com using query parameters
172172

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.
174174

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`
176176

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`.
178178

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:
180183

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+
```
182187

183188
## Dynamic Actor tooling
184189

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.
186203

187204
## Rate limits
188205

0 commit comments

Comments
 (0)