Skip to content

Commit a1561e8

Browse files
committed
feat: Update configuration
1 parent a29177d commit a1561e8

File tree

1 file changed

+23
-13
lines changed
  • sources/platform/integrations/ai

1 file changed

+23
-13
lines changed

sources/platform/integrations/ai/mcp.md

Lines changed: 23 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -152,27 +152,37 @@ By default, the main Actors MCP Server starts with a single default [RAG Web Bro
152152

153153
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.
154154

155-
## Dynamic Actor tooling
155+
## Configure tools for MCP server
156156

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

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
163172

164-
:::note Optional tools
173+
Use query parameter `tools` to enable or disable specific tool categories.
165174

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

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

173179
:::
174180

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

177187
## Rate limits
178188

0 commit comments

Comments
 (0)