@apify/actors-mcp-server 0.15.8-beta.1 → 0.15.8-beta.2

package/README.md

@@ -271,7 +271,7 @@ Legend for the **Enabled by default** column:
 | [`apify--rag-web-browser`](https://apify.com/apify/rag-web-browser) | Actor (see [tool configuration](#tools-configuration)) | An Actor tool to browse the web. | ✅ |
 | [`apify--web-fetch`](https://apify.com/apify/web-fetch) | Actor (see [tool configuration](#tools-configuration)) | An Actor tool to fetch a URL and return its content. | ✅ |
 | `report-problem` | dev | Report a problem with an Apify tool or Actor to the Apify team. | ✅¹ |
-| `get-actor-run-list` | runs | Get a list of an Actor's runs, filterable by status. |  |
+| `get-actor-run-list` | runs | Get a list of Actor runs, filterable by Actor and status. |  |
 | `get-actor-run-log` | runs | Retrieve the logs for a specific Actor run. |  |
 | `get-dataset` | storage | Get metadata about a specific dataset. |  |
 | `get-dataset-schema` | storage | Generate a JSON schema from dataset items. |  |

package/dist/tools/runs/get_actor_run_list.d.ts

@@ -1,6 +1,7 @@
 import type { ToolEntry } from '../../types.js';
 /**
- * https://docs.apify.com/api/v2/act-runs-get
+ * https://docs.apify.com/api/v2/actor-runs-get (all runs of the user)
+ * https://docs.apify.com/api/v2/act-runs-get (runs of one Actor, when `actorId` is given)
  */
 export declare const getActorRunList: ToolEntry;
 //# sourceMappingURL=get_actor_run_list.d.ts.map

package/dist/tools/runs/get_actor_run_list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_actor_run_list.d.ts","sourceRoot":"","sources":["../../../src/tools/runs/get_actor_run_list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AA4BnF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SAmCnB,CAAC"}
+{"version":3,"file":"get_actor_run_list.d.ts","sourceRoot":"","sources":["../../../src/tools/runs/get_actor_run_list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAkCnF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SA8CnB,CAAC"}

package/dist/tools/runs/get_actor_run_list.js

@@ -2,9 +2,15 @@ import { z } from 'zod';
 import { HELPER_TOOLS } from '../../const.js';
 import { TOOL_TYPE } from '../../types.js';
 import { compileSchema } from '../../utils/ajv.js';
-import { respondRaw } from '../../utils/mcp.js';
+import { respondRaw, respondUserError } from '../../utils/mcp.js';
+import { catchNotFound } from '../storage/storage_helpers.js';
 import { actorRunListOutputSchema } from '../structured_output_schemas.js';
 const getUserRunsListArgs = z.object({
+    actorId: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Only list runs of this Actor; accepts an Actor ID or username/name.'),
     offset: z
         .number()
         .describe('Number of array elements that should be skipped at the start. The default value is 0.')
@@ -24,14 +30,16 @@ const getUserRunsListArgs = z.object({
         .describe('Return only runs with the provided status.'),
 });
 /**
- * https://docs.apify.com/api/v2/act-runs-get
+ * https://docs.apify.com/api/v2/actor-runs-get (all runs of the user)
+ * https://docs.apify.com/api/v2/act-runs-get (runs of one Actor, when `actorId` is given)
  */
 export const getActorRunList = Object.freeze({
     type: TOOL_TYPE.INTERNAL,
     name: HELPER_TOOLS.ACTOR_RUN_LIST_GET,
     title: 'Get user runs list',
     description: `List Actor runs for the authenticated user with optional filtering and sorting.
-The results will include run details (including defaultDatasetId and defaultKeyValueStoreId) and can be filtered by status.
+The results will include run details (including defaultDatasetId and defaultKeyValueStoreId) and can be filtered by Actor and by status.
+Pass actorId to list only the runs of one Actor, for example to find its latest run.
 Valid statuses: READY (not allocated), RUNNING (executing), SUCCEEDED (finished), FAILED (failed), TIMING-OUT, TIMED-OUT, ABORTING, ABORTED.
 
 USAGE:
@@ -39,7 +47,8 @@ USAGE:
 
 USAGE EXAMPLES:
 - user_input: List my last 10 runs (newest first)
-- user_input: Show only SUCCEEDED runs`,
+- user_input: Show only SUCCEEDED runs
+- user_input: Show the latest run of apify/web-scraper`,
     inputSchema: z.toJSONSchema(getUserRunsListArgs),
     outputSchema: actorRunListOutputSchema,
     ajvValidate: compileSchema(z.toJSONSchema(getUserRunsListArgs)),
@@ -53,9 +62,18 @@ USAGE EXAMPLES:
     call: async (toolArgs) => {
         const { args, apifyClient } = toolArgs;
         const parsed = getUserRunsListArgs.parse(args);
-        const runs = await apifyClient
-            .runs()
-            .list({ limit: parsed.limit, offset: parsed.offset, desc: parsed.desc, status: parsed.status });
+        const listOptions = {
+            limit: parsed.limit,
+            offset: parsed.offset,
+            desc: parsed.desc,
+            status: parsed.status,
+        };
+        const runs = parsed.actorId
+            ? await catchNotFound(apifyClient.actor(parsed.actorId).runs().list(listOptions))
+            : await apifyClient.runs().list(listOptions);
+        if (!runs) {
+            return respondUserError(`Actor '${parsed.actorId}' not found.`);
+        }
         return respondRaw({
             content: [{ type: 'text', text: JSON.stringify(runs) }],
             structuredContent: runs,

package/dist/tools/runs/get_actor_run_list.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_actor_run_list.js","sourceRoot":"","sources":["../../../src/tools/runs/get_actor_run_list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,uFAAuF,CAAC;SACjG,OAAO,CAAC,CAAC,CAAC;IACf,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,+FAA+F,CAAC;SACzG,OAAO,CAAC,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC;SACF,OAAO,EAAE;SACT,QAAQ,CACL,uHAAuH,CAC1H;SACA,OAAO,CAAC,KAAK,CAAC;IACnB,MAAM,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;SACnG,QAAQ,EAAE;SACV,QAAQ,CAAC,4CAA4C,CAAC;CAC9D,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAc,MAAM,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,kBAAkB;IACrC,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE;;;;;;;;;uCASsB;IACnC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAoB;IACnE,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAC/D,WAAW,EAAE;QACT,KAAK,EAAE,oBAAoB;QAC3B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;QACvC,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,WAAW;aACzB,IAAI,EAAE;aACN,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACpG,OAAO,UAAU,CAAC;YACd,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,iBAAiB,EAAE,IAA0C;SAChE,CAAC,CAAC;IACP,CAAC;CACK,CAAC,CAAC"}
+{"version":3,"file":"get_actor_run_list.js","sourceRoot":"","sources":["../../../src/tools/runs/get_actor_run_list.ts"],"names":[],"mappings":"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"}