Apify MCP Server

Official MCP server connecting AI applications to Apify's web scraping platform with access to thousands of automation actors

View on GitHub Quick Start →

⚡ Quick Install with Claude Code MCP Guide

Connect Claude Code to any remote MCP server with one simple command. Choose between direct HTTP connections or a universal bridge - all configured automatically with our setup wizard.

Get the Claude Code MCP Setup Guide →

🔌 Test MCP Server Connection

Test your connection to the MCP wrapper server using your x-api-key. This validates that your MCP server credentials are configured correctly.

MCP Server API Key (x-api-key)

🚀 Test Full Apify Connection

Test both your MCP server connection AND your Apify platform credentials. This ensures your complete setup is working correctly.

MCP Server API Key (x-api-key)

Apify API Token (x-apify-token)

Apify User ID (x-apify-user-id) - Optional

📡 API Endpoint & Required Headers

POST https://apify.mcp.majewscy.tech

Required HTTP Headers:

Content-Type: application/json

x-api-key: Your MCP server API key

x-apify-token: Your Apify API token (required - from apify.com/account)

x-apify-user-id: Your Apify User ID (optional - for enhanced validation)

🛠️ Available Tools

run_actor

Execute an Apify actor with specified inputs

get_actor_info

Retrieve information about an actor

list_actors

List available actors in the marketplace

get_run_status

Check the status of an actor run

get_dataset

Retrieve data from actor runs

create_task

Create scheduled or webhook-triggered tasks

⚠️ Common Errors & Solutions

401 Unauthorized

Invalid API credentials

Solution: Check your x-api-key and x-apify-token are correct

403 Forbidden

Insufficient permissions

Solution: Ensure your Apify token has the required permissions

429 Rate Limited

Too many requests

Solution: Reduce request frequency or upgrade your Apify plan

Actor Not Found

Specified actor does not exist

Solution: Verify the actor ID or name is correct

🏥 Service Health Check

Checking...

Response Time

Server Status

Protocol Version

2024-11-05

Last Checked

Configuration

// Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
// Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server@latest"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

// HTTP Wrapper Configuration (for remote access)
{
  "apify": {
    "type": "http",
    "url": "https://apify.mcp.majewscy.tech",
    "headers": {
      "x-api-key": "YOUR_API_KEY",
      "x-apify-token": "YOUR_APIFY_TOKEN"
    }
  }
}

// Claude Code: .mcp.json in your project root
{
  "apify": {
    "command": "npx",
    "args": [
      "-y",
      "@apify/actors-mcp-server@latest"
    ],
    "env": {
      "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
    }
  }
}

Features

Enterprise-grade Apify integration for AI assistants

🕷️

Web Scraping

Access thousands of pre-built web scraping actors.

🤖

Automation

Automate web workflows and data extraction tasks.

☁️

Cloud Execution

Run actors on Apify's scalable cloud infrastructure.

📊

Data Export

Export data in multiple formats (JSON, CSV, Excel).

🔄

Scheduled Runs

Set up recurring scraping and automation tasks.

🔐

Proxy Support

Built-in proxy rotation and residential IPs.

📋 Recent Updates from GitHub

Latest Aug 15, 2025

Enhancement: Added Apify logo SVG for better branding
Feature: Added MCP tool configuration options for DXT

Recent Aug 8, 2025

Fix: Improved beta release CI/CD pipeline
Update: Updated DXT descriptions for clarity

Recent Aug 7, 2025

Fix: Changed log message format for actor-mcp

Recent Aug 6, 2025

Feature: Updated DXT file structure
Fix: Resolved issue with adding non-existent Actors
Feature: Changed logs to structured format for better debugging

Recent Aug 5, 2025

Improvement: Changed info logs to debug level for cleaner output

Recent Aug 1, 2025

Feature: Added tools dump functionality

View all commits on GitHub →

🔐 Update Server