Skip to content

Commit bc7a3ce

Browse files
MQ37TC-MO
andauthored
docs: update MCP dynamic tooing section (#1697)
**Merge after release of mcp.apify.com** --------- Co-authored-by: Michał Olender <92638966+TC-MO@users.noreply.github.com>
1 parent 2e0ec66 commit bc7a3ce

File tree

1 file changed

+18
-6
lines changed
  • sources/platform/integrations/ai

1 file changed

+18
-6
lines changed

sources/platform/integrations/ai/mcp.md

Lines changed: 18 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -148,13 +148,25 @@ In summary, you can start with a broad set (everything open and discoverable) or
148148

149149
## Dynamic Actor tooling
150150

151-
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:
151+
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:
152152

153-
- _Actor discovery and management:_ Search for [Actors](https://docs.apify.com/platform/actors) (`search-actors`), view details (`get-actor-details`), and dynamically add or remove tools (`add-actor`, `remove-actor`).
154-
- _Actor execution and monitoring:_ Start [Actor runs](https://docs.apify.com/platform/actors/running/runs-and-builds#runs), fetch run results (`get-actor-run`), logs (`get-actor-log`), and abort runs (`abort-actor-run`).
155-
- _Dataset access:_ List [datasets](https://docs.apify.com/platform/storage/dataset), retrieve dataset info and items (`get-dataset`, `get-dataset-list`, `get-dataset-items`).
156-
- _Key-value store access:_ List [key-value stores](https://docs.apify.com/platform/storage/key-value-store), view keys, and retrieve records (`get-key-value-store-list`, `get-key-value-store`, `get-key-value-store-keys`, `get-key-value-store-record`).
157-
- _Built-in help tool:_ A static helper (`apify-actor-help-tool`) that returns usage info for the Apify MCP Server.
153+
- _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`).
154+
- _Apify documentation:_ Search Apify documentation (`search-apify-docs`) and fetch specific documents (`fetch-apify-docs`).
155+
- _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`).
156+
- _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.
157+
158+
:::note Optional tools
159+
160+
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:
161+
162+
- `docs`: Search and fetch Apify documentation.
163+
- `runs`: Get Actor runs list, run details, and logs from a specific Actor run.
164+
- `storage`: Access datasets, key-value stores, and their records.
165+
- `preview`: Experimental tools in preview mode.
166+
167+
:::
168+
169+
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`.
158170

159171
## Troubleshooting
160172

0 commit comments

Comments
 (0)