MCP Directory

How to add Apify Actors MCP (RAG Web Browser) to Windsurf

Run Apify's RAG Web Browser and 5,000+ Actors as MCP tools — web search and scrape to clean markdown. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 600★ · stdio · apikey · official

Windsurf config for Apify Actors MCP (RAG Web Browser)

npx -y @apify/actors-mcp-server
{
  "mcpServers": {
    "apify-actors-mcp-rag-web-browser": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server"
      ],
      "env": {
        "APIFY_TOKEN": "<your-apify-api-token>"
      }
    }
  }
}

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Apify Actors MCP (RAG Web Browser) config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Apify Actors MCP (RAG Web Browser)'s tools become available to Cascade.

Before you start

  • Node.js v22+ for the local stdio server (or just an OAuth-capable client for the hosted server)
  • An Apify account and API token (APIFY_TOKEN) from apify.com — the hosted server can also authenticate via OAuth without manual token entry
  • An MCP client such as Claude Desktop/Claude.ai, VS Code, Cursor, or ChatGPT

What Apify Actors MCP (RAG Web Browser) can do in Windsurf

apify-slash-rag-web-browser

Preconfigured RAG Web Browser Actor: web search and scrape pages to clean markdown for grounding LLMs.

search-actors

Discover Actors in the Apify Store by query.

fetch-actor-details

Retrieve an Actor's specs, README, pricing, and input/output schemas.

call-actor

Run an Actor with given input and return its results.

add-actor

Dynamically add a specific Actor as a callable tool (experimental).

get-actor-run

Inspect the status and metadata of a specific Actor run.

get-dataset-items

Fetch and paginate the dataset output produced by an Actor run.

get-key-value-store-record

Read a stored value from an Actor's key-value store.

Security

The APIFY_TOKEN bills against your Apify account and the add-actor flow can dynamically grant new tools, so review which Actors a session can run. Scraped web content is untrusted and may contain prompt-injection aimed at your model.

Apify Actors MCP (RAG Web Browser) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Apify Actors MCP (RAG Web Browser) config there under the "mcpServers" key and restart the client.

Is Apify Actors MCP (RAG Web Browser) safe to use with Windsurf?

The APIFY_TOKEN bills against your Apify account and the add-actor flow can dynamically grant new tools, so review which Actors a session can run. Scraped web content is untrusted and may contain prompt-injection aimed at your model.

Hosted server or local stdio — which should I use?

The hosted Streamable HTTP server at mcp.apify.com is recommended: it supports OAuth and is the only way to dynamically use rental/paid Actors. Use the local stdio npm server when you need a fully local setup with your own APIFY_TOKEN.

How do I authenticate?

Locally, set the APIFY_TOKEN env var to your Apify API token. With the hosted server you can authenticate via OAuth or send the token as a Bearer header.

Is the SSE endpoint still supported?

No. The legacy /sse endpoint is deprecated; connect to the base https://mcp.apify.com URL using Streamable HTTP instead.

View repo Full Apify Actors MCP (RAG Web Browser) page