Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v0.17.4 (2026-10-07), so it may lag behind newer releases.
Replace `get-actor-log` and `tools=get-actor-log` with `get-actor-run-log`; the old selector loads no tools. `get-actor-run-list` also accepts `actorId`.
Action requiredAffects: Configurations and calls using the old run-log name.
Standby Actors without an MCP endpoint and with an empty input schema are rejected explicitly. Standby Actors with input properties can run normally; configured MCP endpoints are proxied.
Refresh stored proxied MCP tool names: names now use `username--actor-name--originToolName` rather than a server-hash prefix; long names can have hash suffixes.
Action requiredInferredAffects: Clients storing or invoking proxied Actor-MCP tool names.
Replace `tools=add-actor` or `tools=experimental` with `tools=call-actor`. Remove `enableAddingActors`, `enable-adding-actors`, and `enableActorAutoLoading`; retired selectors load no tools.
Action requiredAffects: Configurations using dynamic Actor-loading selectors or flags.
Remove direct access to `ActorsMcpServer.server` and `.taskStore`; both members are now private to the transport adapter. Use the public `connect()` and `close()` lifecycle methods; no replacement for raw member access is stated.
Action requiredAffects: TypeScript applications that access ActorsMcpServer.server or ActorsMcpServer.taskStore.
Read run storage from `storages.datasets` and `storages.keyValueStores` maps. `get-dataset` no longer returns raw `schema`; use `get-dataset-schema` to infer one from items.
Action requiredInferredAffects: Consumers of run storage fields or the raw dataset schema.
Actor calls no longer inline dataset items. Read the returned `datasetId` and call `get-dataset-items`; run and storage helper tools are now auto-injected.
Action requiredAffects: Integrations expecting dataset previews in Actor-call responses.
Local stdio now sends Sentry error reports and session tracking while telemetry is enabled; `--telemetry-enabled=false` or `TELEMETRY_ENABLED=false` disables it.
Tool-call telemetry is enabled by default. Opt out with `--telemetry-enabled=false` or `TELEMETRY_ENABLED=false`; hosted sessions accept `telemetry-enabled=false`.
Behavior changedAffects: Users of local and hosted sessions.
Build Actor versions and inspect their build status and logs.
Details
Build, account-Actor listing, source reading, and Actor deletion tools are available. x402 clients must read the accepted-payment array instead of flat metadata.
Available in @apify/actors-mcp-server 0.17.4; local use requires Node.js 22+. Enable non-default tools explicitly.
Added: Build an Actor version and inspect build lists, sta…Added: List Actors you own or that are shared with you, in…Added: Read an Actor version's file list, requested file c…Added: Permanently delete an Actor from your Apify account.Action required / inferred: Pay for Actor runs through an x402-capable MCP clie…Behavior changed: Create, inspect, update, publish, and unpublish reu…Now works: Retrieve, filter, and paginate datasets and read ke…Improved / inferred: Connect a local MCP client to Apify through stdio.
Schedule tools create, inspect, update, and delete recurring runs; the run-log tool is renamed and run lists can filter by Actor.
Available in @apify/actors-mcp-server 0.16.0; local use requires Node.js 22+. Enable non-default tools explicitly.
Added: Create, inspect, update, and delete schedules for A…Action required: List Actor runs, inspect their status, and retrieve…Now works: Run Apify Actors to extract website data and automa…Improved: Find Apify Actors and inspect their descriptions an…Limit lifted: Report a problem with an Apify tool or Actor to the…Behavior changed: View Actor search results and details in interactiv…
Save reusable Actor tasks and publish their landing pages.
Details
Task tools create, inspect, update, publish, and unpublish saved Actor configurations. Web Fetch joins the default tools and proxied tool names change.
Available in @apify/actors-mcp-server 0.15.3; local use requires Node.js 22+. Enable non-default tools explicitly.
Added: Create, inspect, update, publish, and unpublish reu…Added: Fetch a specific URL as Markdown, text, HTML, or li…Behavior changed: Search the web and retrieve page content through th…Action required / inferred: Run Apify Actors to extract website data and automa…Now works: List Actor runs, inspect their status, and retrieve…Behavior changed / inferred
View Actor widgets when Claude Desktop strips structured content.
Details
Widgets recover stripped structured content; local startup and the bundle manifest align with the existing Node.js 22 package minimum.
Available in @apify/actors-mcp-server 0.14.3; local use requires Node.js 22+. Enable non-default tools explicitly.
Now works: View Actor search results and details in interactiv…Action required: Connect a local MCP client to Apify through stdio.Improved / inferred: Find Apify Actors and inspect their descriptions an…
v0.14.2 with v0.11.6, v0.11.7, v0.12.0, v0.13.0, v0.14.0, v0.14.1
Read Apify data directly through MCP resources.
Details
API-backed resources expose storage and run data; `add-actor` is retired and 2026-07-28 MCP requests gain a stateless HTTP path.
Available in @apify/actors-mcp-server 0.14.2; local use requires Node.js 22+. Enable non-default tools explicitly.
Added / inferred: Read Apify API data through MCP resource URLs.Added: Report a problem with an Apify tool or Actor to the…Removed: Add discovered Actors as new tools during an MCP se…Action requiredImproved / inferred: Connect an MCP client to the hosted Apify server us…Behavior changed / inferred: Retrieve, filter, and paginate datasets and read ke…Behavior changed: Find Apify Actors and inspect their descriptions an…Now works: Run Apify Actors to extract website data and automa…Action required
Find all datasets and key-value stores produced by an Actor run.
Details
Run results expose named storage maps, while dataset metadata omits the raw schema and empty key-value values are preserved.
Available in @apify/actors-mcp-server 0.11.5; local use requires Node.js 22+. Enable non-default tools explicitly.
Improved / inferred: List Actor runs, inspect their status, and retrieve…Action required / inferred: Retrieve, filter, and paginate datasets and read ke…Behavior changed / inferred: Search Apify documentation and fetch documentation…
Retrieve binary key-value store records as MCP content.
Details
Storage tools return structured output and binary records use MCP content blocks. Legacy SSE, `get-actor-output`, and the example news prompt are removed.
Available in @apify/actors-mcp-server 0.11.2; tool access depends on session configuration and authentication.
Improved: Retrieve, filter, and paginate datasets and read ke…Action required / inferredAction required: Connect an MCP client to the hosted Apify server us…Removed / inferred: Start a news search using the predefined GetLatestN…Action required / inferredAction required / inferredNow works / inferred: Pay for Actor runs through an x402-capable MCP clie…
Set spending and result limits when running Actors.
Details
`callOptions` accepts build and spending limits; Actor calls return metadata for a separate dataset fetch. Run, storage, and abort tools are automatically included with Actor tools.
Available in @apify/actors-mcp-server 0.10.11; tool access depends on session configuration and authentication.
Improved: Run Apify Actors to extract website data and automa…Action required: Retrieve, filter, and paginate datasets and read ke…Added: Abort a running Actor, optionally allowing graceful…Improved: List Actor runs, inspect their status, and retrieve…Action required / inferredAction required: Connect a local MCP client to Apify through stdio.Behavior changed / inferred: View Actor search results and details in interactiv…Now works / inferred: Run long operations using MCP tasks and retrieve th…Improved: Find Apify Actors and inspect their descriptions an…Improved: Pay for Actor runs through an x402-capable MCP clie…Behavior changed: Pay for Actor runs with Skyfire PAY tokens.
x402 joins Skyfire payments; Actor tool names adopt `username--actor-name`, and dataset counts distinguish total items from preview items.
Available in @apify/actors-mcp-server 0.9.16; tool access depends on session configuration and authentication.
Added / inferred: Pay for Actor runs through an x402-capable MCP clie…Behavior changed / inferred: Run Apify Actors to extract website data and automa…Action required: Retrieve, filter, and paginate datasets and read ke…Limit lifted: Connect a local MCP client to Apify through stdio.Improved: Run long operations using MCP tasks and retrieve th…Improved: Search Apify documentation and fetch documentation…Now works: View Actor search results and details in interactiv…
Widgets adopt MCP Apps metadata, the development HTTP endpoint moves to `/`, and the package requires Node.js 22.
Available in @apify/actors-mcp-server 0.9.11; tool access depends on session configuration and authentication.
Improved: View Actor search results and details in interactiv…Action required: Connect an MCP client to the hosted Apify server us…Action required / inferred: Connect a local MCP client to Apify through stdio.
Public tools work over unauthenticated stdio, and Actor details join the public tool set. Search defaults to five results and details prefer README summaries.
Available in @apify/actors-mcp-server 0.9.7; tool access depends on session configuration and authentication.
Limit lifted: Find Apify Actors and inspect their descriptions an…Limit lifted: Connect a local MCP client to Apify through stdio.Behavior changedNow works: View Actor search results and details in interactiv…Improved: List Actor runs, inspect their status, and retrieve…
The hosted server allows unauthenticated `search-actors`; Actor details can include output schemas.
Available in @apify/actors-mcp-server 0.8.3; execution requires Apify authentication or supported payments.
Limit lifted: Find Apify Actors and inspect their descriptions an…Improved: Run Apify Actors to extract website data and automa…Action required: Connect an MCP client to the hosted Apify server us…
View Actor search results in interactive client widgets.
Details
UI mode adds widgets; `call-actor` supports long-running tasks and no longer takes `step`.
Available in @apify/actors-mcp-server 0.7.4; execution requires Apify authentication or supported payments.
Added: View Actor search results and details in interactiv…Improved: Run long operations using MCP tasks and retrieve th…Action required: Run Apify Actors to extract website data and automa…Now works: Pay for Actor runs with Skyfire PAY tokens.
Long-running tasks are supported, documentation tools cover Crawlee, and stdio session handling is repaired.
Available in @apify/actors-mcp-server 0.6.5; execution requires Apify authentication or supported payments.
Added / inferred: Run long operations using MCP tasks and retrieve th…Improved: Search Apify documentation and fetch documentation…Now works: Connect a local MCP client to Apify through stdio.
Documentation tools allow unauthenticated access; key tools return structured output, and telemetry is enabled by default.
Available in @apify/actors-mcp-server 0.6.2; execution requires Apify authentication or supported payments.
Limit lifted: Search Apify documentation and fetch documentation…Improved / inferred: Run Apify Actors to extract website data and automa…Action required: Connect a local MCP client to Apify through stdio.Behavior changed
Run Apify scraping and automation Actors from an MCP client.
Details
Baseline before the 12-month history window: discover and run Actors, inspect runs, retrieve storage data, and search documentation.
Version 0.4.21 supports hosted OAuth or token authentication and local stdio with Node.js 18+ and APIFY_TOKEN.
Added: Find Apify Actors and inspect their descriptions an…Added: Run Apify Actors to extract website data and automa…Added: Search the web and retrieve page content through th…Added: Retrieve, filter, and paginate datasets and read ke…Added: List Actor runs, inspect their status, and retrieve…Added: Search Apify documentation and fetch documentation…Added: Connect a local MCP client to Apify through stdio.Added: Connect an MCP client to the hosted Apify server us…Added: Add discovered Actors as new tools during an MCP se…Added: Start a news search using the predefined GetLatestN…Added / inferred: Pay for Actor runs with Skyfire PAY tokens.