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: README.md
+6-74Lines changed: 6 additions & 74 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -95,18 +95,13 @@ When a tool is called, the arguments are automatically passed to the Actor by th
95
95
You can refer to the specific Actor's documentation for a list of available arguments.
96
96
97
97
### Helper tools
98
+
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:
98
99
99
-
The server provides a set of helper tools to discover available Actors and retrieve their details:
100
-
-`get-actor-details`: Retrieves documentation, input schema, and details about a specific Actor.
101
-
-`discover-actors`: Searches for relevant Actors using keywords and returns their details.
102
-
103
-
There are also tools to manage the available tools list. However, dynamically adding and removing tools requires the MCP client to have the capability to update the tools list (handle `ToolListChangedNotificationSchema`), which is typically not supported.
104
-
105
-
You can try this functionality using the [Apify Tester MCP Client](https://apify.com/jiri.spilka/tester-mcp-client) Actor.
106
-
To enable it, set the `enableAddingActors` parameter.
107
-
108
-
-`add-actor-as-tool`: Adds an Actor by name to the available tools list without executing it, requiring user consent to run later.
109
-
-`remove-actor-from-tool`: Removes an Actor by name from the available tools list when it's no longer needed.
100
+
- Actor discovery and management: Search for Actors (`search-actors`), view details (`get-actor-details`), and dynamically add or remove tools (`add-actor`, `remove-actor`).
101
+
- Actor execution and monitoring: Start Actor runs, fetch run results (`get-actor-run`), logs (`get-actor-log`), and abort runs (`abort-actor-run`).
102
+
- Dataset access: List datasets, retrieve dataset info and items (`get-dataset`, `get-dataset-list`, `get-dataset-items`).
103
+
- Key-value store access: List key-value stores, view keys, and retrieve records (`get-key-value-store-list`, `get-key-value-store`, `get-key-value-store-keys`, `get-key-value-store-record`).
104
+
- Built-in help tool: A static helper (`apify-actor-help-too`) that returns usage info for the Apify MCP Server.
110
105
111
106
## Prompt & Resources
112
107
@@ -160,44 +155,6 @@ In the client settings, you need to provide server configuration:
160
155
}
161
156
}
162
157
```
163
-
Alternatively, you can use [clientSse.ts](https://github.com/apify/actor-mcp-server/tree/main/src/examples/clientSse.ts) script or test the server using `curl` </> commands.
164
-
165
-
1. Initiate Server-Sent-Events (SSE) by sending a GET request to the following URL:
The MCP server will start the Actor `lukaskrivka/google-maps-with-contact-details` with the provided arguments as input parameters.
188
-
For this POST request, the server will respond with:
189
-
190
-
```text
191
-
Accepted
192
-
```
193
-
194
-
3. Receive the response. The server will invoke the specified Actor as a tool using the provided query parameters and stream the response back to the client via SSE.
195
-
The response will be returned as JSON text.
196
-
197
-
```text
198
-
event: message
199
-
data: {"result":{"content":[{"type":"text","text":"{\"searchString\":\"restaurants in San Francisco\",\"rank\":1,\"title\":\"Gary Danko\",\"description\":\"Renowned chef Gary Danko's fixed-price menus of American cuisine ... \",\"price\":\"$100+\"...}}]}}
0 commit comments