Skip to main content
Glama
Sign In

AI Web Research & Research Brief Agent

by io.github.industrial-platform-ai
OverviewDiscussionsAdmin

Get Actor run

get-actor-run
Read-onlyIdempotent

Get detailed information about a specific Actor run.

Returns run result: status, storages (datasets/keyValueStores alias map), stats, summary, nextStep.

  • summary describes the past (e.g. "SUCCEEDED in 22s. 47 items; 3 fields available.").

  • nextStep prescribes one primary follow-up action with identifiers interpolated (e.g. "Use get-dataset-items with datasetId=...").

  • waitSecs (0–45, default 30) waits up to that many seconds for terminal status before returning.

USAGE:

  • Use to check the status of a run started by any Actor-running tool.

  • Pass waitSecs > 0 to block until terminal (or until the cap elapses).

USAGE EXAMPLES:

  • user_input: Show details of run y2h7sK3Wc

  • user_input: Wait for run y2h7sK3Wc to finish

This tool requires an x402 payment. Include a valid x402 payment signature in the request metadata (_meta["x402/payment"]). Your MCP client must support the x402 payment protocol.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "runId": "<runId>"
    },
    "name": "get-actor-run"
  }
}

Input Schema

NameRequiredDescriptionDefault
runIdYesThe ID of the Actor run.
waitSecsNoMaximum seconds to wait for the run to reach a terminal state (SUCCEEDED, FAILED, ABORTED, TIMED-OUT). 0 returns immediately with the current status. Cap: 45. Default: 30.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "actorId": {
-        "description": "Stable Apify Actor ID from the run record",
-        "type": "string"
-      },
-      "actorName": {
-        "description": "\"username/actor-name\"",
-        "type": "string"
-      },
-      "apifyConsoleUrl": {
-        "description": "Personalized Apify Console link to the run; present only for Console sessions",
-        "type": "string"
-      },
-      "exitCode": {
-        "description": "Actor process exit code; populated for terminal states (especially FAILED)",
-        "type": "number"
-      },
-      "finishedAt": {
-        "description": "ISO timestamp when the run finished (terminal states only)",
-        "type": "string"
-      },
-      "nextStep": {
-        "description": "One primary follow-up action with identifiers interpolated",
-        "type": "string"
-      },
-      "runId": {
-        "description": "Actor run ID",
-        "type": "string"
-      },
-      "startedAt": {
-        "description": "ISO timestamp when the run started",
-        "type": "string"
-      },
-      "stats": {
-        "description": "Run statistics",
-        "properties": {
-          "computeUnits": {
-            "type": "number"
-          },
-          "memMaxBytes": {
-            "type": "number"
-          },
-          "runTimeSecs": {
-            "type": "number"
-          }
-        },
-        "type": "object"
-      },
-      "status": {
-        "description": "Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED",
-        "type": "string"
-      },
-      "statusMessage": {
-        "description": "Pass-through from Apify run.statusMessage",
-        "type": "string"
-      },
-      "storages": {
-        "description": "Dataset and key-value store metadata, keyed by alias. \"default\" is always the primary entry.",
-        "properties": {
-          "datasets": {
-            "additionalProperties": {
-              "properties": {
-                "apifyConsoleUrl": {
-                  "description": "Personalized Apify Console link to the dataset; present only for Console sessions",
-                  "type": "string"
-                },
-                "fields": {
-                  "description": "Dataset field paths in dot notation (e.g. [\"metadata.url\"])",
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "id": {
-                  "description": "Dataset ID",
-                  "type": "string"
-                },
-                "inflatedBytes": {
-                  "description": "Approximate uncompressed byte size of the dataset. Use with itemCount to pick limit/fields before fetching.",
-                  "type": "number"
-                },
-                "itemCount": {
-                  "type": "number"
-                },
-                "name": {
-                  "type": "string"
-                },
-                "title": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "description": "Map of dataset alias → metadata. Key \"default\" is always the run's primary dataset.",
-            "properties": {
-              "default": {
-                "properties": {
-                  "apifyConsoleUrl": {
-                    "description": "Personalized Apify Console link to the dataset; present only for Console sessions",
-                    "type": "string"
-                  },
-                  "fields": {
-                    "description": "Dataset field paths in dot notation (e.g. [\"metadata.url\"])",
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  "id": {
-                    "description": "Dataset ID",
-                    "type": "string"
-                  },
-                  "inflatedBytes": {
-                    "description": "Approximate uncompressed byte size of the dataset. Use with itemCount to pick limit/fields before fetching.",
-                    "type": "number"
-                  },
-                  "itemCount": {
-                    "type": "number"
-                  },
-                  "name": {
-                    "type": "string"
-                  },
-                  "title": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "id"
-                ],
-                "type": "object"
-              }
-            },
-            "required": [
-              "default"
-            ],
-            "type": "object"
-          },
-          "keyValueStores": {
-            "additionalProperties": {
-              "properties": {
-                "apifyConsoleUrl": {
-                  "description": "Personalized Apify Console link to the store; present only for Console sessions",
-                  "type": "string"
-                },
-                "id": {
-                  "description": "Key-value store ID",
-                  "type": "string"
-                },
-                "keyCount": {
-                  "description": "Total number of keys (omitted when truncated)",
-                  "type": "number"
-                },
-                "keys": {
-                  "description": "Up to 50 key names",
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "name": {
-                  "type": "string"
-                },
-                "title": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "description": "Map of key-value store alias → metadata. Key \"default\" is always the run's primary store.",
-            "properties": {
-              "default": {
-                "properties": {
-                  "apifyConsoleUrl": {
-                    "description": "Personalized Apify Console link to the store; present only for Console sessions",
-                    "type": "string"
-                  },
-                  "id": {
-                    "description": "Key-value store ID",
-                    "type": "string"
-                  },
-                  "keyCount": {
-                    "description": "Total number of keys (omitted when truncated)",
-                    "type": "number"
-                  },
-                  "keys": {
-                    "description": "Up to 50 key names",
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  "name": {
-                    "type": "string"
-                  },
-                  "title": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "id"
-                ],
-                "type": "object"
-              }
-            },
-            "required": [
-              "default"
-            ],
-            "type": "object"
-          }
-        },
-        "type": "object"
-      },
-      "summary": {
-        "description": "Past-tense summary of the run state",
-        "type": "string"
-      },
-      "tip": {
-        "description": "Advisory guidance RAG Web Browser wrote to its key-value store under the reserved \"TIP\" key",
-        "properties": {
-          "caveat": {
-            "description": "Present when this session cannot run the Actor the tip recommends",
-            "type": "string"
-          },
-          "level": {
-            "description": "Omitted when the Actor wrote an unrecognized level",
-            "enum": [
-              "info",
-              "warning"
-            ],
-            "type": "string"
-          },
-          "message": {
-            "description": "Truncated to 300 characters, with a trailing ellipsis if the Actor's message was longer",
-            "type": "string"
-          },
-          "recommendedActorId": {
-            "description": "Apify Actor ID the tip recommends, when it names one",
-            "type": "string"
-          }
-        },
-        "required": [
-          "message"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "runId",
-      "actorId",
-      "status",
-      "storages",
-      "summary",
-      "nextStep"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "accepts": {
-        "items": {
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "error": {
-        "type": "string"
-      },
-      "resource": {
-        "type": "object"
-      },
-      "x402Version": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "x402Version",
-      "accepts"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "actorId": {
+        "description": "Stable Apify Actor ID from the run record",
+        "type": "string"
+      },
+      "actorName": {
+        "description": "\"username/actor-name\"",
+        "type": "string"
+      },
+      "apifyConsoleUrl": {
+        "description": "Personalized Apify Console link to the run; present only for Console sessions",
+        "type": "string"
+      },
+      "exitCode": {
+        "description": "Actor process exit code; populated for terminal states (especially FAILED)",
+        "type": "number"
+      },
+      "finishedAt": {
+        "description": "ISO timestamp when the run finished (terminal states only)",
+        "type": "string"
+      },
+      "nextStep": {
+        "description": "One primary follow-up action with identifiers interpolated",
+        "type": "string"
+      },
+      "runId": {
+        "description": "Actor run ID",
+        "type": "string"
+      },
+      "startedAt": {
+        "description": "ISO timestamp when the run started",
+        "type": "string"
+      },
+      "stats": {
+        "description": "Run statistics",
+        "properties": {
+          "computeUnits": {
+            "type": "number"
+          },
+          "memMaxBytes": {
+            "type": "number"
+          },
+          "runTimeSecs": {
+            "type": "number"
+          }
+        },
+        "type": "object"
+      },
+      "status": {
+        "description": "Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED",
+        "type": "string"
+      },
+      "statusMessage": {
+        "description": "Pass-through from Apify run.statusMessage",
+        "type": "string"
+      },
+      "storages": {
+        "description": "Dataset and key-value store metadata, keyed by alias. \"default\" is always the primary entry.",
+        "properties": {
+          "datasets": {
+            "additionalProperties": {
+              "properties": {
+                "apifyConsoleUrl": {
+                  "description": "Personalized Apify Console link to the dataset; present only for Console sessions",
+                  "type": "string"
+                },
+                "fields": {
+                  "description": "Paths that work as a fields selection (e.g. [\"results\", \"metadata.url\"]); an array field appears by its top-level name.",
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "id": {
+                  "description": "Dataset ID",
+                  "type": "string"
+                },
+                "inflatedBytes": {
+                  "description": "Approximate uncompressed byte size of the dataset. Use with itemCount to pick limit/fields before fetching.",
+                  "type": "number"
+                },
+                "itemCount": {
+                  "type": "number"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "description": "Map of dataset alias → metadata. Key \"default\" is always the run's primary dataset.",
+            "properties": {
+              "default": {
+                "properties": {
+                  "apifyConsoleUrl": {
+                    "description": "Personalized Apify Console link to the dataset; present only for Console sessions",
+                    "type": "string"
+                  },
+                  "fields": {
+                    "description": "Paths that work as a fields selection (e.g. [\"results\", \"metadata.url\"]); an array field appears by its top-level name.",
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "id": {
+                    "description": "Dataset ID",
+                    "type": "string"
+                  },
+                  "inflatedBytes": {
+                    "description": "Approximate uncompressed byte size of the dataset. Use with itemCount to pick limit/fields before fetching.",
+                    "type": "number"
+                  },
+                  "itemCount": {
+                    "type": "number"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "default"
+            ],
+            "type": "object"
+          },
+          "keyValueStores": {
+            "additionalProperties": {
+              "properties": {
+                "apifyConsoleUrl": {
+                  "description": "Personalized Apify Console link to the store; present only for Console sessions",
+                  "type": "string"
+                },
+                "id": {
+                  "description": "Key-value store ID",
+                  "type": "string"
+                },
+                "keyCount": {
+                  "description": "Total number of keys (omitted when truncated)",
+                  "type": "number"
+                },
+                "keys": {
+                  "description": "Up to 50 key names",
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "description": "Map of key-value store alias → metadata. Key \"default\" is always the run's primary store.",
+            "properties": {
+              "default": {
+                "properties": {
+                  "apifyConsoleUrl": {
+                    "description": "Personalized Apify Console link to the store; present only for Console sessions",
+                    "type": "string"
+                  },
+                  "id": {
+                    "description": "Key-value store ID",
+                    "type": "string"
+                  },
+                  "keyCount": {
+                    "description": "Total number of keys (omitted when truncated)",
+                    "type": "number"
+                  },
+                  "keys": {
+                    "description": "Up to 50 key names",
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "default"
+            ],
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "summary": {
+        "description": "Past-tense summary of the run state",
+        "type": "string"
+      },
+      "tip": {
+        "description": "Advisory guidance RAG Web Browser wrote to its key-value store under the reserved \"TIP\" key",
+        "properties": {
+          "caveat": {
+            "description": "Present when this session cannot run the Actor the tip recommends",
+            "type": "string"
+          },
+          "level": {
+            "description": "Omitted when the Actor wrote an unrecognized level",
+            "enum": [
+              "info",
+              "warning"
+            ],
+            "type": "string"
+          },
+          "message": {
+            "description": "Truncated to 300 characters, with a trailing ellipsis if the Actor's message was longer",
+            "type": "string"
+          },
+          "recommendedActorId": {
+            "description": "Apify Actor ID the tip recommends, when it names one",
+            "type": "string"
+          }
+        },
+        "required": [
+          "message"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "runId",
+      "actorId",
+      "status",
+      "storages",
+      "summary",
+      "nextStep"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "accepts": {
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "error": {
+        "type": "string"
+      },
+      "resource": {
+        "type": "object"
+      },
+      "x402Version": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "x402Version",
+      "accepts"
+    ],
+    "type": "object"
+  }
+]
  2. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "actorId": {
-        "description": "Stable Apify Actor ID from the run record",
-        "type": "string"
-      },
-      "actorName": {
-        "description": "\"username/actor-name\"",
-        "type": "string"
-      },
-      "apifyConsoleUrl": {
-        "description": "Personalized Apify Console link to the run; present only for Console sessions",
-        "type": "string"
-      },
-      "exitCode": {
-        "description": "Actor process exit code; populated for terminal states (especially FAILED)",
-        "type": "number"
-      },
-      "finishedAt": {
-        "description": "ISO timestamp when the run finished (terminal states only)",
-        "type": "string"
-      },
-      "nextStep": {
-        "description": "One primary follow-up action with identifiers interpolated",
-        "type": "string"
-      },
-      "runId": {
-        "description": "Actor run ID",
-        "type": "string"
-      },
-      "startedAt": {
-        "description": "ISO timestamp when the run started",
-        "type": "string"
-      },
-      "stats": {
-        "description": "Run statistics",
-        "properties": {
-          "computeUnits": {
-            "type": "number"
-          },
-          "memMaxBytes": {
-            "type": "number"
-          },
-          "runTimeSecs": {
-            "type": "number"
-          }
-        },
-        "type": "object"
-      },
-      "status": {
-        "description": "Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED",
-        "type": "string"
-      },
-      "statusMessage": {
-        "description": "Pass-through from Apify run.statusMessage",
-        "type": "string"
-      },
-      "storages": {
-        "description": "Dataset and key-value store metadata, keyed by alias. \"default\" is always the primary entry.",
-        "properties": {
-          "datasets": {
-            "additionalProperties": {
-              "properties": {
-                "apifyConsoleUrl": {
-                  "description": "Personalized Apify Console link to the dataset; present only for Console sessions",
-                  "type": "string"
-                },
-                "fields": {
-                  "description": "Dataset field paths in dot notation (e.g. [\"metadata.url\"])",
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "id": {
-                  "description": "Dataset ID",
-                  "type": "string"
-                },
-                "inflatedBytes": {
-                  "description": "Approximate uncompressed byte size of the dataset. Use with itemCount to pick limit/fields before fetching.",
-                  "type": "number"
-                },
-                "itemCount": {
-                  "type": "number"
-                },
-                "name": {
-                  "type": "string"
-                },
-                "title": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "description": "Map of dataset alias → metadata. Key \"default\" is always the run's primary dataset.",
-            "properties": {
-              "default": {
-                "properties": {
-                  "apifyConsoleUrl": {
-                    "description": "Personalized Apify Console link to the dataset; present only for Console sessions",
-                    "type": "string"
-                  },
-                  "fields": {
-                    "description": "Dataset field paths in dot notation (e.g. [\"metadata.url\"])",
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  "id": {
-                    "description": "Dataset ID",
-                    "type": "string"
-                  },
-                  "inflatedBytes": {
-                    "description": "Approximate uncompressed byte size of the dataset. Use with itemCount to pick limit/fields before fetching.",
-                    "type": "number"
-                  },
-                  "itemCount": {
-                    "type": "number"
-                  },
-                  "name": {
-                    "type": "string"
-                  },
-                  "title": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "id"
-                ],
-                "type": "object"
-              }
-            },
-            "required": [
-              "default"
-            ],
-            "type": "object"
-          },
-          "keyValueStores": {
-            "additionalProperties": {
-              "properties": {
-                "apifyConsoleUrl": {
-                  "description": "Personalized Apify Console link to the store; present only for Console sessions",
-                  "type": "string"
-                },
-                "id": {
-                  "description": "Key-value store ID",
-                  "type": "string"
-                },
-                "keyCount": {
-                  "description": "Total number of keys (omitted when truncated)",
-                  "type": "number"
-                },
-                "keys": {
-                  "description": "Up to 50 key names",
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "name": {
-                  "type": "string"
-                },
-                "title": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "description": "Map of key-value store alias → metadata. Key \"default\" is always the run's primary store.",
-            "properties": {
-              "default": {
-                "properties": {
-                  "apifyConsoleUrl": {
-                    "description": "Personalized Apify Console link to the store; present only for Console sessions",
-                    "type": "string"
-                  },
-                  "id": {
-                    "description": "Key-value store ID",
-                    "type": "string"
-                  },
-                  "keyCount": {
-                    "description": "Total number of keys (omitted when truncated)",
-                    "type": "number"
-                  },
-                  "keys": {
-                    "description": "Up to 50 key names",
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  "name": {
-                    "type": "string"
-                  },
-                  "title": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "id"
-                ],
-                "type": "object"
-              }
-            },
-            "required": [
-              "default"
-            ],
-            "type": "object"
-          }
-        },
-        "type": "object"
-      },
-      "summary": {
-        "description": "Past-tense summary of the run state",
-        "type": "string"
-      },
-      "tip": {
-        "description": "Advisory guidance RAG Web Browser wrote to its key-value store under the reserved \"TIP\" key",
-        "properties": {
-          "level": {
-            "description": "Omitted when the Actor wrote an unrecognized level",
-            "enum": [
-              "info",
-              "warning"
-            ],
-            "type": "string"
-          },
-          "message": {
-            "description": "Truncated to 300 characters, with a trailing ellipsis if the Actor's message was longer",
-            "type": "string"
-          },
-          "recommendedActorId": {
-            "description": "Apify Actor ID the tip recommends running next, when it names one — pass directly as `actor` to call-actor or fetch-actor-details",
-            "type": "string"
-          }
-        },
-        "required": [
-          "message"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "runId",
-      "actorId",
-      "status",
-      "storages",
-      "summary",
-      "nextStep"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "accepts": {
-        "items": {
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "error": {
-        "type": "string"
-      },
-      "resource": {
-        "type": "object"
-      },
-      "x402Version": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "x402Version",
-      "accepts"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "actorId": {
+        "description": "Stable Apify Actor ID from the run record",
+        "type": "string"
+      },
+      "actorName": {
+        "description": "\"username/actor-name\"",
+        "type": "string"
+      },
+      "apifyConsoleUrl": {
+        "description": "Personalized Apify Console link to the run; present only for Console sessions",
+        "type": "string"
+      },
+      "exitCode": {
+        "description": "Actor process exit code; populated for terminal states (especially FAILED)",
+        "type": "number"
+      },
+      "finishedAt": {
+        "description": "ISO timestamp when the run finished (terminal states only)",
+        "type": "string"
+      },
+      "nextStep": {
+        "description": "One primary follow-up action with identifiers interpolated",
+        "type": "string"
+      },
+      "runId": {
+        "description": "Actor run ID",
+        "type": "string"
+      },
+      "startedAt": {
+        "description": "ISO timestamp when the run started",
+        "type": "string"
+      },
+      "stats": {
+        "description": "Run statistics",
+        "properties": {
+          "computeUnits": {
+            "type": "number"
+          },
+          "memMaxBytes": {
+            "type": "number"
+          },
+          "runTimeSecs": {
+            "type": "number"
+          }
+        },
+        "type": "object"
+      },
+      "status": {
+        "description": "Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED",
+        "type": "string"
+      },
+      "statusMessage": {
+        "description": "Pass-through from Apify run.statusMessage",
+        "type": "string"
+      },
+      "storages": {
+        "description": "Dataset and key-value store metadata, keyed by alias. \"default\" is always the primary entry.",
+        "properties": {
+          "datasets": {
+            "additionalProperties": {
+              "properties": {
+                "apifyConsoleUrl": {
+                  "description": "Personalized Apify Console link to the dataset; present only for Console sessions",
+                  "type": "string"
+                },
+                "fields": {
+                  "description": "Dataset field paths in dot notation (e.g. [\"metadata.url\"])",
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "id": {
+                  "description": "Dataset ID",
+                  "type": "string"
+                },
+                "inflatedBytes": {
+                  "description": "Approximate uncompressed byte size of the dataset. Use with itemCount to pick limit/fields before fetching.",
+                  "type": "number"
+                },
+                "itemCount": {
+                  "type": "number"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "description": "Map of dataset alias → metadata. Key \"default\" is always the run's primary dataset.",
+            "properties": {
+              "default": {
+                "properties": {
+                  "apifyConsoleUrl": {
+                    "description": "Personalized Apify Console link to the dataset; present only for Console sessions",
+                    "type": "string"
+                  },
+                  "fields": {
+                    "description": "Dataset field paths in dot notation (e.g. [\"metadata.url\"])",
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "id": {
+                    "description": "Dataset ID",
+                    "type": "string"
+                  },
+                  "inflatedBytes": {
+                    "description": "Approximate uncompressed byte size of the dataset. Use with itemCount to pick limit/fields before fetching.",
+                    "type": "number"
+                  },
+                  "itemCount": {
+                    "type": "number"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "default"
+            ],
+            "type": "object"
+          },
+          "keyValueStores": {
+            "additionalProperties": {
+              "properties": {
+                "apifyConsoleUrl": {
+                  "description": "Personalized Apify Console link to the store; present only for Console sessions",
+                  "type": "string"
+                },
+                "id": {
+                  "description": "Key-value store ID",
+                  "type": "string"
+                },
+                "keyCount": {
+                  "description": "Total number of keys (omitted when truncated)",
+                  "type": "number"
+                },
+                "keys": {
+                  "description": "Up to 50 key names",
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "description": "Map of key-value store alias → metadata. Key \"default\" is always the run's primary store.",
+            "properties": {
+              "default": {
+                "properties": {
+                  "apifyConsoleUrl": {
+                    "description": "Personalized Apify Console link to the store; present only for Console sessions",
+                    "type": "string"
+                  },
+                  "id": {
+                    "description": "Key-value store ID",
+                    "type": "string"
+                  },
+                  "keyCount": {
+                    "description": "Total number of keys (omitted when truncated)",
+                    "type": "number"
+                  },
+                  "keys": {
+                    "description": "Up to 50 key names",
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "default"
+            ],
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "summary": {
+        "description": "Past-tense summary of the run state",
+        "type": "string"
+      },
+      "tip": {
+        "description": "Advisory guidance RAG Web Browser wrote to its key-value store under the reserved \"TIP\" key",
+        "properties": {
+          "caveat": {
+            "description": "Present when this session cannot run the Actor the tip recommends",
+            "type": "string"
+          },
+          "level": {
+            "description": "Omitted when the Actor wrote an unrecognized level",
+            "enum": [
+              "info",
+              "warning"
+            ],
+            "type": "string"
+          },
+          "message": {
+            "description": "Truncated to 300 characters, with a trailing ellipsis if the Actor's message was longer",
+            "type": "string"
+          },
+          "recommendedActorId": {
+            "description": "Apify Actor ID the tip recommends, when it names one",
+            "type": "string"
+          }
+        },
+        "required": [
+          "message"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "runId",
+      "actorId",
+      "status",
+      "storages",
+      "summary",
+      "nextStep"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "accepts": {
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "error": {
+        "type": "string"
+      },
+      "resource": {
+        "type": "object"
+      },
+      "x402Version": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "x402Version",
+      "accepts"
+    ],
+    "type": "object"
+  }
+]
  3. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "actorId": {
-        "description": "Stable Apify Actor ID from the run record",
-        "type": "string"
-      },
-      "actorName": {
-        "description": "\"username/actor-name\"",
-        "type": "string"
-      },
-      "apifyConsoleUrl": {
-        "description": "Personalized Apify Console link to the run; present only for Console sessions",
-        "type": "string"
-      },
-      "exitCode": {
-        "description": "Actor process exit code; populated for terminal states (especially FAILED)",
-        "type": "number"
-      },
-      "finishedAt": {
-        "description": "ISO timestamp when the run finished (terminal states only)",
-        "type": "string"
-      },
-      "nextStep": {
-        "description": "One primary follow-up action with identifiers interpolated",
-        "type": "string"
-      },
-      "runId": {
-        "description": "Actor run ID",
-        "type": "string"
-      },
-      "startedAt": {
-        "description": "ISO timestamp when the run started",
-        "type": "string"
-      },
-      "stats": {
-        "description": "Run statistics",
-        "properties": {
-          "computeUnits": {
-            "type": "number"
-          },
-          "memMaxBytes": {
-            "type": "number"
-          },
-          "runTimeSecs": {
-            "type": "number"
-          }
-        },
-        "type": "object"
-      },
-      "status": {
-        "description": "Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED",
-        "type": "string"
-      },
-      "statusMessage": {
-        "description": "Pass-through from Apify run.statusMessage",
-        "type": "string"
-      },
-      "storages": {
-        "description": "Dataset and key-value store metadata, keyed by alias. \"default\" is always the primary entry.",
-        "properties": {
-          "datasets": {
-            "additionalProperties": {
-              "properties": {
-                "apifyConsoleUrl": {
-                  "description": "Personalized Apify Console link to the dataset; present only for Console sessions",
-                  "type": "string"
-                },
-                "fields": {
-                  "description": "Dataset field paths in dot notation (e.g. [\"metadata.url\"])",
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "id": {
-                  "description": "Dataset ID",
-                  "type": "string"
-                },
-                "inflatedBytes": {
-                  "description": "Approximate uncompressed byte size of the dataset. Use with itemCount to pick limit/fields before fetching.",
-                  "type": "number"
-                },
-                "itemCount": {
-                  "type": "number"
-                },
-                "name": {
-                  "type": "string"
-                },
-                "title": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "description": "Map of dataset alias → metadata. Key \"default\" is always the run's primary dataset.",
-            "properties": {
-              "default": {
-                "properties": {
-                  "apifyConsoleUrl": {
-                    "description": "Personalized Apify Console link to the dataset; present only for Console sessions",
-                    "type": "string"
-                  },
-                  "fields": {
-                    "description": "Dataset field paths in dot notation (e.g. [\"metadata.url\"])",
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  "id": {
-                    "description": "Dataset ID",
-                    "type": "string"
-                  },
-                  "inflatedBytes": {
-                    "description": "Approximate uncompressed byte size of the dataset. Use with itemCount to pick limit/fields before fetching.",
-                    "type": "number"
-                  },
-                  "itemCount": {
-                    "type": "number"
-                  },
-                  "name": {
-                    "type": "string"
-                  },
-                  "title": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "id"
-                ],
-                "type": "object"
-              }
-            },
-            "required": [
-              "default"
-            ],
-            "type": "object"
-          },
-          "keyValueStores": {
-            "additionalProperties": {
-              "properties": {
-                "apifyConsoleUrl": {
-                  "description": "Personalized Apify Console link to the store; present only for Console sessions",
-                  "type": "string"
-                },
-                "id": {
-                  "description": "Key-value store ID",
-                  "type": "string"
-                },
-                "keyCount": {
-                  "description": "Total number of keys (omitted when truncated)",
-                  "type": "number"
-                },
-                "keys": {
-                  "description": "Up to 50 key names",
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "name": {
-                  "type": "string"
-                },
-                "title": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id"
-              ],
-              "type": "object"
-            },
-            "description": "Map of key-value store alias → metadata. Key \"default\" is always the run's primary store.",
-            "properties": {
-              "default": {
-                "properties": {
-                  "apifyConsoleUrl": {
-                    "description": "Personalized Apify Console link to the store; present only for Console sessions",
-                    "type": "string"
-                  },
-                  "id": {
-                    "description": "Key-value store ID",
-                    "type": "string"
-                  },
-                  "keyCount": {
-                    "description": "Total number of keys (omitted when truncated)",
-                    "type": "number"
-                  },
-                  "keys": {
-                    "description": "Up to 50 key names",
-                    "items": {
-                      "type": "string"
-                    },
-                    "type": "array"
-                  },
-                  "name": {
-                    "type": "string"
-                  },
-                  "title": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "id"
-                ],
-                "type": "object"
-              }
-            },
-            "required": [
-              "default"
-            ],
-            "type": "object"
-          }
-        },
-        "type": "object"
-      },
-      "summary": {
-        "description": "Past-tense summary of the run state",
-        "type": "string"
-      }
-    },
-    "required": [
-      "runId",
-      "actorId",
-      "status",
-      "storages",
-      "summary",
-      "nextStep"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "accepts": {
-        "items": {
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "error": {
-        "type": "string"
-      },
-      "resource": {
-        "type": "object"
-      },
-      "x402Version": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "x402Version",
-      "accepts"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "actorId": {
+        "description": "Stable Apify Actor ID from the run record",
+        "type": "string"
+      },
+      "actorName": {
+        "description": "\"username/actor-name\"",
+        "type": "string"
+      },
+      "apifyConsoleUrl": {
+        "description": "Personalized Apify Console link to the run; present only for Console sessions",
+        "type": "string"
+      },
+      "exitCode": {
+        "description": "Actor process exit code; populated for terminal states (especially FAILED)",
+        "type": "number"
+      },
+      "finishedAt": {
+        "description": "ISO timestamp when the run finished (terminal states only)",
+        "type": "string"
+      },
+      "nextStep": {
+        "description": "One primary follow-up action with identifiers interpolated",
+        "type": "string"
+      },
+      "runId": {
+        "description": "Actor run ID",
+        "type": "string"
+      },
+      "startedAt": {
+        "description": "ISO timestamp when the run started",
+        "type": "string"
+      },
+      "stats": {
+        "description": "Run statistics",
+        "properties": {
+          "computeUnits": {
+            "type": "number"
+          },
+          "memMaxBytes": {
+            "type": "number"
+          },
+          "runTimeSecs": {
+            "type": "number"
+          }
+        },
+        "type": "object"
+      },
+      "status": {
+        "description": "Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED",
+        "type": "string"
+      },
+      "statusMessage": {
+        "description": "Pass-through from Apify run.statusMessage",
+        "type": "string"
+      },
+      "storages": {
+        "description": "Dataset and key-value store metadata, keyed by alias. \"default\" is always the primary entry.",
+        "properties": {
+          "datasets": {
+            "additionalProperties": {
+              "properties": {
+                "apifyConsoleUrl": {
+                  "description": "Personalized Apify Console link to the dataset; present only for Console sessions",
+                  "type": "string"
+                },
+                "fields": {
+                  "description": "Dataset field paths in dot notation (e.g. [\"metadata.url\"])",
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "id": {
+                  "description": "Dataset ID",
+                  "type": "string"
+                },
+                "inflatedBytes": {
+                  "description": "Approximate uncompressed byte size of the dataset. Use with itemCount to pick limit/fields before fetching.",
+                  "type": "number"
+                },
+                "itemCount": {
+                  "type": "number"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "description": "Map of dataset alias → metadata. Key \"default\" is always the run's primary dataset.",
+            "properties": {
+              "default": {
+                "properties": {
+                  "apifyConsoleUrl": {
+                    "description": "Personalized Apify Console link to the dataset; present only for Console sessions",
+                    "type": "string"
+                  },
+                  "fields": {
+                    "description": "Dataset field paths in dot notation (e.g. [\"metadata.url\"])",
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "id": {
+                    "description": "Dataset ID",
+                    "type": "string"
+                  },
+                  "inflatedBytes": {
+                    "description": "Approximate uncompressed byte size of the dataset. Use with itemCount to pick limit/fields before fetching.",
+                    "type": "number"
+                  },
+                  "itemCount": {
+                    "type": "number"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "default"
+            ],
+            "type": "object"
+          },
+          "keyValueStores": {
+            "additionalProperties": {
+              "properties": {
+                "apifyConsoleUrl": {
+                  "description": "Personalized Apify Console link to the store; present only for Console sessions",
+                  "type": "string"
+                },
+                "id": {
+                  "description": "Key-value store ID",
+                  "type": "string"
+                },
+                "keyCount": {
+                  "description": "Total number of keys (omitted when truncated)",
+                  "type": "number"
+                },
+                "keys": {
+                  "description": "Up to 50 key names",
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "type": "object"
+            },
+            "description": "Map of key-value store alias → metadata. Key \"default\" is always the run's primary store.",
+            "properties": {
+              "default": {
+                "properties": {
+                  "apifyConsoleUrl": {
+                    "description": "Personalized Apify Console link to the store; present only for Console sessions",
+                    "type": "string"
+                  },
+                  "id": {
+                    "description": "Key-value store ID",
+                    "type": "string"
+                  },
+                  "keyCount": {
+                    "description": "Total number of keys (omitted when truncated)",
+                    "type": "number"
+                  },
+                  "keys": {
+                    "description": "Up to 50 key names",
+                    "items": {
+                      "type": "string"
+                    },
+                    "type": "array"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "title": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "id"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "default"
+            ],
+            "type": "object"
+          }
+        },
+        "type": "object"
+      },
+      "summary": {
+        "description": "Past-tense summary of the run state",
+        "type": "string"
+      },
+      "tip": {
+        "description": "Advisory guidance RAG Web Browser wrote to its key-value store under the reserved \"TIP\" key",
+        "properties": {
+          "level": {
+            "description": "Omitted when the Actor wrote an unrecognized level",
+            "enum": [
+              "info",
+              "warning"
+            ],
+            "type": "string"
+          },
+          "message": {
+            "description": "Truncated to 300 characters, with a trailing ellipsis if the Actor's message was longer",
+            "type": "string"
+          },
+          "recommendedActorId": {
+            "description": "Apify Actor ID the tip recommends running next, when it names one — pass directly as `actor` to call-actor or fetch-actor-details",
+            "type": "string"
+          }
+        },
+        "required": [
+          "message"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "runId",
+      "actorId",
+      "status",
+      "storages",
+      "summary",
+      "nextStep"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "accepts": {
+        "items": {
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "error": {
+        "type": "string"
+      },
+      "resource": {
+        "type": "object"
+      },
+      "x402Version": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "x402Version",
+      "accepts"
+    ],
+    "type": "object"
+  }
+]
  4. First observed

TDQS

A4.1/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint and destructiveHint=false, but the description adds materially new behavior: a mandatory x402 payment with the exact metadata key _meta["x402/payment"], the client-side protocol prerequisite, and the blocking semantics of waitSecs. It also explains that summary is retrospective and nextStep prescribes a follow-up with interpolated identifiers, which an agent needs to chain calls.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with the purpose, then grouped into returns, usage and examples with short bullet lines that are easy to scan. The two user_input examples are marginally redundant with the USAGE bullets but are compact and directly actionable.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Although an output schema exists (so return values did not strictly need spelling out), the description still identifies the key response fields an agent must reason over, plus the payment prerequisite and the polling/blocking tradeoff. Nothing needed to invoke this tool correctly—ID, wait window, auth, follow-up routing—is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%: runId and waitSecs are both fully documented in the input schema, including range, default and terminal states. The description's note that waitSecs > 0 blocks until terminal or until the cap elapses largely restates the schema, so this is the baseline case where the schema carries parameter meaning.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence names a specific verb and resource ('Get detailed information about a specific Actor run') and the field list (status, storages, stats, summary, nextStep) makes the purpose concrete. It is distinguishable from abort-actor-run and get-dataset-items by subject matter, but it never explicitly contrast-routes against a sibling, which keeps it just short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

A dedicated USAGE block states when to reach for this tool ('check the status of a run started by any Actor-running tool') and gives the operational rule for blocking with waitSecs > 0, reinforced by two user_input examples. It lacks an explicit when-not-to-use clause or a named alternative for retrieving run outputs by other means.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All AI Web Research & Research Brief Agent toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources