Log inSubmit server
Actors MCP Server logo

Actors MCP Server

by apify

Connects AI assistants to Apify Actors for web scraping, crawling, search, and structured data extraction.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Actors MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "apify-actors-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

apify/actors-mcp-server connects MCP-compatible AI assistants to Apify’s catalog of 3,000+ cloud Actors for extracting data from websites, social platforms, search engines, maps, and online stores. It lets an assistant search for Actors, inspect their details, run them, and retrieve dataset results through MCP tools. The hosted endpoint at https://mcp.apify.com uses streamable HTTP and OAuth or bearer authentication, while local integrations can run the package over stdio. Reach for it when an agent needs a specialized scraper or browser automation workflow without implementing the target site integration itself.

Use cases

  • Search the Apify Store for a scraper matching a data-collection task
  • Run Actors to extract social media, search, maps, or e-commerce data
  • Fetch and convert web pages into Markdown, text, HTML, or links
  • Crawl website content for research and retrieval workflows

Key features

  • Search and inspect Apify Actors
  • Run Actors through MCP
  • Retrieve Actor datasets
  • Fetch web pages in multiple formats
  • Crawl website content
  • Connect through hosted streamable HTTP or local stdio

Tools13

What Actors MCP Server lets your agent do. Expand a tool for its parameters.

Self-reported~44 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

30/30 checks healthy over the last 78d

Supply-chain signal

1 high-severity advisory on record for this package. Most advisories affect transitive dependencies and may not be exploitable in this server's actual usage — this is a directional signal, not a security audit.

Critical 0High 1Medium 1Low 0

Scanned 8d ago via OSV.dev · @apify/actors-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars13kStargazers on the source repository.
npm downloads72kPackage downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.
Tools exposed13Callable tools this server registers over MCP.
Directory activity8 viewsConfig copies, upvotes, and views on AllMCPs.

How Actors MCP Server works

What apify/actors-mcp-server does

apify/actors-mcp-server exposes Apify Actors as tools that an MCP-compatible AI assistant can discover and invoke. Actors are cloud-based scrapers, crawlers, and automation tools available through the Apify Store. They cover tasks such as extracting Facebook posts, collecting Google Maps contact details, scraping search results, retrieving Instagram data, browsing the web for retrieval-augmented generation, and fetching pages as Markdown, plain text, HTML, or links.

The server is suited to search and data-extraction workflows where the required website or platform is already supported by an Apify Actor. Instead of building a scraper into the agent, the assistant can select an Actor and pass it the task-specific input.

How it works

The server provides MCP tools for finding and using Actors. An assistant can search the Actor catalog, retrieve Actor metadata, call an Actor, and read the resulting dataset. It also exposes tools for fetching Apify documentation and for using Apify’s web-fetch and website-content-crawler capabilities.

The recommended hosted deployment is available at https://mcp.apify.com over streamable HTTP. Clients can authenticate through OAuth or send an Authorization: Bearer <APIFY_TOKEN> header. A local stdio deployment is also available through the npm package, which is useful for desktop and command-line MCP clients.

Setup and configuration

For the hosted option, configure an MCP client with https://mcp.apify.com. OAuth-enabled clients can connect using the URL; other configurations can provide an Apify bearer token. The former /sse endpoint should not be used because the server now uses streamable HTTP at the URL without the /sse suffix.

For a local stdio setup, install or run the package through npx:

Terminal
npx @apify/actors-mcp-server

Set APIFY_TOKEN to an Apify API token in the MCP client environment. The command accepts additional options, which can be inspected with npx @apify/actors-mcp-server --help. A downloadable MCPB bundle is also available for one-click installation.

Tools and capabilities

Available capabilities include:

  • search-actors for locating Actors in the Apify catalog.
  • fetch-actor-details for inspecting an Actor before running it.
  • call-actor for starting an Actor with task input.
  • get-dataset for retrieving data produced by an Actor run.
  • apify--web-fetch for fetching URL content in formats including Markdown, plain text, HTML, and links.
  • apify--website-content-crawler for crawling website content.
  • fetch-apify-docs for accessing Apify documentation through MCP.

The hosted service supports OAuth and features that depend on client capabilities. Actor runs can also be paid through Apify tokens or supported agentic payment methods, including AGI, direct x402 for Pay Per Event Actors, and Skyfire.

Limitations and notes

Client support for dynamic tool discovery and other MCP features can vary. The hosted service includes features that are unavailable in the local stdio mode, including output-schema inference for structured Actor results. Actor availability, inputs, output shape, runtime, and cost depend on the selected Apify Actor. Local use requires an Apify token unless an applicable hosted payment method is used.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Actors MCP Server

apify/actors-mcp-server is an MCP server that connects AI assistants to Apify’s cloud Actors. Its main tools search the Actor catalog, fetch Actor details, run Actors, retrieve datasets, fetch web pages, crawl websites, and access Apify documentation for search and data-extraction workflows.

Run `npx @apify/actors-mcp-server` for a local stdio setup and provide the `APIFY_TOKEN` environment variable. Alternatively, configure an MCP client with the hosted streamable HTTP endpoint at `https://mcp.apify.com`, using OAuth or a bearer token.

Yes, apify/actors-mcp-server works with Cursor. Configure Cursor to use the hosted endpoint at `https://mcp.apify.com` or connect it to the local stdio command and provide the required Apify token.

Yes, it can use Apify Actors for Google search results, Google Maps, social media, e-commerce sites, and general websites. The available task, input schema, and output depend on the Actor selected from the Apify Store.

Use the hosted endpoint for OAuth, streamable HTTP, and hosted-only features such as output-schema inference. Use the local stdio command for local integrations and command-line MCP clients; it requires an Apify API token.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewActors MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/apify-actors-mcp-server?style=directory)](https://allmcps.com/mcp/apify-actors-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/apify-actors-mcp-server"><img src="https://allmcps.com/api/badge/apify-actors-mcp-server?style=directory" alt="Actors MCP Server on AllMCPs" /></a>