`apify_run_actor`

Pack: apify · Endpoint: https://gateway.pipeworx.io/apify/mcp

Run an Apify Actor (a cloud scraping/automation program) and get its dataset results in a single blocking call. The run is capped at 300 seconds. Pass the Actor input as an input object — its shape depends on the Actor. Example: apify_run_actor({ actorId: “apify~web-scraper”, input: { startUrls: [{ url: “https://example.com” }] }, _apiKey: “your-token” }). Browse Actors at https://apify.com/store.

Parameters

Name	Type	Required	Description
`actorId`	string	yes	Actor identifier. Use the tilde form “username~~actor-name” (e.g. “apify~~web-scraper”), a “username/actor-name” form (auto-normalized to tilde), or the raw Actor ID.
`input`	object	no	The Actor input JSON. Passed as the run INPUT. Shape is Actor-specific — see the Actor page in the Apify Store. Optional; defaults to {}.
`_apiKey`	string	yes	Your Apify API token (get one at https://console.apify.com/sign-up, Settings → Integrations).

Example call

Arguments

{
  "actorId": "apify~web-scraper",
  "input": {
    "startUrls": [
      {
        "url": "https://example.com"
      }
    ]
  },
  "_apiKey": "your-apify-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/apify/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"apify_run_actor","arguments":{"actorId":"apify~web-scraper","input":{"startUrls":[{"url":"https://example.com"}]},"_apiKey":"your-apify-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('apify_run_actor', {
  "actorId": "apify~web-scraper",
  "input": {
    "startUrls": [
      {
        "url": "https://example.com"
      }
    ]
  },
  "_apiKey": "your-apify-api-key"
});

More examples

{
  "actorId": "apify~website-content-crawler",
  "input": {
    "startUrls": [
      {
        "url": "https://docs.example.com"
      }
    ],
    "maxCrawlDepth": 2
  },
  "_apiKey": "your-apify-api-key"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "apify": {
      "url": "https://gateway.pipeworx.io/apify/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

apify_run_actor