home / mcp / apify mcp server

Apify MCP Server

actors-mcp-server

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "ampcome-mcps-apify-mcp": {
      "url": "https://actors-mcp-server.apify.actor",
      "headers": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

The Apify MCP Server exposes Apify Actors as tools you can use from AI agents or MCP clients. You can run it as an online HTTP SSE server or as a local stdio server, enabling secure, configurable access to your Actors for tasks like data extraction, web search, and more.

How to use

Interact with the Apify MCP Server using an MCP client that supports either Server-Sent Events (SSE) or stdio transport. SSE lets you send messages to the server and receive responses over HTTP. Stdio lets you run the server locally and communicate through standard input/output. You can load Actors dynamically, search for new Actors, and execute Actors as tools within your AI workflows.

How to install

Prerequisites you need before installing the server:

- Node.js (v18 or higher)

- An Apify API Token (APIFY_TOKEN)

- A compatible MCP client for your preferred transport (SSE or stdio)

Additional setup guidance

Choose the transport that suits your workflow and configure the server accordingly. The HTTP SSE variant provides a remote endpoint you can connect to with your MCP client. The local stdio variant runs on your machine and connects via standard input/output.

MCP connection options and examples

{
  "type": "http",
  "name": "actors_mcp_http",
  "url": "https://actors-mcp-server.apify.actor",
  "args": []
}

Use an authenticated remote endpoint with an MCP client by providing your API token in the environment configuration.

{
  "type": "http",
  "name": "actors_mcp_http_with_task",
  "url": "https://USERNAME--actors-mcp-server-task.apify.actor",
  "args": []
}

Local stdio configuration examples

Run the local MCP server using the stdio transport. The complete command and arguments are shown here for a typical setup.

{
  "type": "stdio",
  "name": "actors_mcp_stdio",
  "command": "npx",
  "args": ["-y", "@apify/actors-mcp-server"]
}

Dynamic actor loading example

You can load specific Actors at startup by including them in the arguments.

{
  "type": "stdio",
  "name": "actors_mcp_stdio_with_actors",
  "command": "npx",
  "args": [
    "-y",
    "@apify/actors-mcp-server",
    "--actors",
    "lukaskrivka/google-maps-with-contact-details,apify/instagram-scraper"
  ]
}

Available tools

apify/rag-web-browser

A Rag Web Browser Actor tool that searches and browses the web to gather data.

search-actors

Discover Actors available in the MCP ecosystem and obtain details.

get-actor-details

Fetch detailed information about a specific Actor.

add-actor

Dynamically add an Actor to the MCP server configuration.

search-apify-docs

Search the Apify documentation for topics and guides.

fetch-apify-docs

Retrieve specific Apify docs or pages for reference.

apify-actor-help-tool

A built-in helper tool that returns usage information for the Apify MCP Server.