Apify

Provides access to Apify actors, runs, datasets, tasks, and more via MCP for AI assistants.

python

0

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "fvegah-mcp-apify": {
      "command": "/absolute/path/to/mcp-apify/.venv/bin/python",
      "args": [
        "-m",
        "mcp_apify.server"
      ],
      "env": {
        "APIFY_API_TOKEN": "apify_api_xxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

You run an MCP server to let AI assistants interact with your Apify account. This server exposes actors, runs, datasets, and more through a stable MCP interface, letting you manage your Apify resources with natural language prompts and automated workflows.

How to use

You connect an MCP client to the Apify MCP server, then ask the assistant to list actors, start or monitor runs, fetch datasets, or inspect schedules. The assistant chooses the appropriate tools to perform actions like listing your actors, starting a run with input, retrieving run outputs, and checking dataset items. Use natural language prompts such as “List my actors,” “Show the status of run abc123,” or “Get the latest dataset items.” You can also manage tasks, key-value stores, and schedules through supported commands. The goal is to let you interact with Apify resources without manually navigating the Apify UI.

How to install

Prerequisites you need before installing and running the MCP server.

Clone the project and create a Python virtual environment, then install in editable mode.

Option 1: Install from source

git clone https://github.com/fvegah/mcp-apify.git
cd mcp-apify
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e .

Option 2: Install with uv (recommended)

git clone https://github.com/fvegah/mcp-apify.git
cd mcp-apify
uv venv
source .venv/bin/activate
uv pip install -e .

Available tools

get_user_info

Get information about the authenticated user.

list_actors

List all actors (created or used by user).

get_actor

Get details of a specific actor.

list_actor_runs

List runs for a specific actor.

list_user_runs

List all runs across all actors.

get_run

Get details of a specific run.

get_last_run

Get the most recent run of an actor.

run_actor

Start a new actor run with optional input.

abort_run

Stop a running actor execution.

resurrect_run

Restart a finished run.

get_run_log

Retrieve the log output of a run.

list_tasks

List all saved actor tasks.

get_task

Get task configuration details.

run_task

Execute a task with optional input override.

list_task_runs

List runs for a specific task.

get_task_last_run

Get the most recent task run.

list_datasets

List all datasets.

get_dataset

Get dataset metadata.

get_dataset_items

Retrieve items from a dataset.

get_run_dataset_items

Get items from a run's default dataset.

list_key_value_stores

List all key-value stores.

get_key_value_store

Get store metadata.

list_keys

List keys in a store.

get_record

Retrieve a specific record.

get_run_output

Get the OUTPUT record from a run.

list_schedules

List all schedules.

get_schedule

Get schedule configuration.

get_schedule_log

Get schedule execution history.