actors-mcp-server
OfficialApify 모델 컨텍스트 프로토콜(MCP) 서버
모든 Apify Actor 에 대한 MCP 서버 구현. 이 서버를 통해 MCP 서버 구성에서 정의할 수 있는 하나 이상의 Apify Actor와 상호 작용할 수 있습니다.
서버는 두 가지 방법으로 사용할 수 있습니다.
🇦 MCP 서버 액터 – SSE(Server-Sent Events)를 통해 접근 가능한 HTTP 서버, 가이드 참조
⾕ MCP 서버 Stdio – 표준 입력/출력(stdio)을 통해 사용 가능한 로컬 서버, 가이드 참조
💬 테스터 MCP 클라이언트를 사용하여 채팅과 같은 UI를 사용하여 MCP 서버와 상호 작용할 수도 있습니다.
🎯 Apify MCP 서버는 무슨 역할을 하나요?
MCP 서버 액터를 사용하면 AI 어시스턴트가 모든 Apify 액터를 특정 작업을 수행하는 도구로 사용할 수 있습니다. 예를 들어 다음과 같은 작업이 가능합니다.
Facebook 게시물 스크래퍼를 사용하여 여러 페이지/프로필의 Facebook 게시물에서 데이터를 추출합니다.
Google Maps 이메일 추출기를 사용하여 Google Maps 연락처 세부 정보 추출
Google 검색 결과 스크래퍼를 사용하여 Google 검색 엔진 결과 페이지(SERP)를 스크래핑합니다.
Instagram Scraper를 사용하여 Instagram 게시물, 프로필, 장소, 사진 및 댓글을 스크래핑하세요.
RAG 웹 브라우저를 사용하여 웹을 검색하고 상위 N개 URL을 스크래핑하여 해당 콘텐츠를 반환합니다.
MCP 클라이언트
Apify MCP 서버와 상호 작용하려면 다음과 같은 MCP 클라이언트를 사용할 수 있습니다.
Claude Desktop (Stdio만 지원)
Visual Studio Code (Stdio 및 SSE 지원)
LibreChat (Stdio 및 SSE 지원, 그러나 Authorization 헤더 없음)
Apify Tester MCP 클라이언트 (Authorization 헤더를 통한 SSE 지원)
https://modelcontextprotocol.io/clients 의 다른 클라이언트
https://glama.ai/mcp/clients 에서 더 많은 고객을 만나보세요
Actors를 MCP 서버와 통합한 경우 다음 질문을 할 수 있습니다.
"웹에서 검색하여 AI 에이전트에 대한 최근 동향을 요약하세요"
"샌프란시스코 최고의 이탈리아 레스토랑 10곳을 찾아보세요"
"더 록의 인스타그램 프로필을 찾아 분석하세요"
"소스 URL을 사용하여 모델 컨텍스트 프로토콜을 사용하는 방법에 대한 단계별 가이드 제공"
"어떤 Apify Actor를 사용할 수 있나요?"
다음 이미지는 Apify MCP 서버가 Apify 플랫폼 및 AI 클라이언트와 상호 작용하는 방식을 보여줍니다.

MCP 테스터 클라이언트를 사용하면 액터를 동적으로 로드할 수 있지만, 다른 MCP 클라이언트에서는 아직 지원되지 않습니다. 또한 더 많은 기능을 추가할 계획입니다. 자세한 내용은 로드맵을 참조하세요.
🔄 모델 컨텍스트 프로토콜이란 무엇인가요?
모델 컨텍스트 프로토콜(MCP)은 Claude Desktop과 같은 AI 애플리케이션(및 AI 에이전트)이 외부 도구 및 데이터 소스에 연결할 수 있도록 합니다. MCP는 AI 애플리케이션, AI 에이전트, 로컬 또는 원격 리소스 간의 안전하고 제어된 상호작용을 가능하게 하는 개방형 프로토콜입니다.
자세한 내용은 Model Context Protocol 웹사이트나 블로그 게시물 MCP란 무엇이고 왜 중요한가요?를 참조하세요.
🤖 MCP 서버는 AI 에이전트와 어떤 관련이 있나요?
Apify MCP 서버는 MCP 프로토콜을 통해 Apify의 Actor를 노출하여 MCP 프로토콜을 구현하는 AI 에이전트나 프레임워크가 모든 Apify Actor에 액세스하여 데이터 추출, 웹 검색 및 기타 작업을 위한 도구로 사용할 수 있도록 합니다.
AI 에이전트에 대해 자세히 알아보려면 블로그 게시물 " AI 에이전트란 무엇인가?"를 참조하시고 Apify에서 엄선한 AI 에이전트 컬렉션을 살펴보세요. Apify에서 나만의 AI 에이전트를 구축하고 수익을 창출하고 싶으신가요? Apify 플랫폼에서 AI 에이전트를 생성, 게시 및 수익화하는 단계별 가이드를 확인해 보세요.
🧱 구성 요소
도구
배우들
모든 Apify Actor를 도구로 사용할 수 있습니다. 기본적으로 서버는 아래 지정된 Actor로 미리 구성되어 있지만, Actor 입력을 제공하여 이를 재정의할 수 있습니다.
지엑스피1
MCP 서버는 Actor 입력 스키마를 로드하고 Actor에 해당하는 MCP 도구를 생성합니다. RAG 웹 브라우저 의 입력 스키마 예시를 참조하세요.
도구 이름은 항상 apify/rag-web-browser 와 같이 전체 Actor 이름이어야 합니다. MCP 도구의 인수는 Actor의 입력 매개변수를 나타냅니다. 예를 들어 apify/rag-web-browser Actor의 경우 인수는 다음과 같습니다.
{
"query": "restaurants in San Francisco",
"maxResults": 3
}입력 매개변수나 호출할 Actor를 지정할 필요가 없습니다. 모든 것은 LLM에서 관리합니다. 도구가 호출되면 LLM이 자동으로 Actor에 인수를 전달합니다. 사용 가능한 인수 목록은 해당 Actor의 설명서를 참조하세요.
도우미 도구
서버는 사용 가능한 액터를 발견하고 해당 세부 정보를 검색하기 위한 일련의 도우미 도구를 제공합니다.
get-actor-details: 특정 Actor에 대한 설명서, 입력 스키마 및 세부 정보를 검색합니다.discover-actors: 키워드를 사용하여 관련 Actor를 검색하고 해당 세부 정보를 반환합니다.
사용 가능한 도구 목록을 관리하는 도구도 있습니다. 하지만 도구를 동적으로 추가하고 제거하려면 MCP 클라이언트가 도구 목록을 업데이트할 수 있는 기능( ToolListChangedNotificationSchema 핸들)이 필요하지만, 이는 일반적으로 지원되지 않습니다.
Apify Tester MCP Client Actor를 사용하여 이 기능을 사용해 볼 수 있습니다. 활성화하려면 enableAddingActors 매개변수를 설정하세요.
add-actor-as-tool: 실행하지 않고 사용 가능한 도구 목록에 Actor를 이름으로 추가합니다. 나중에 실행하려면 사용자 동의가 필요합니다.remove-actor-from-tool: 더 이상 필요하지 않은 Actor를 사용 가능한 도구 목록에서 제거합니다.
Related MCP server: Apify MCP Server
프롬프트 및 리소스
서버는 리소스와 프롬프트를 제공하지 않습니다. 향후 Apify의 데이터셋 과 키-값 저장소를 리소스로 추가할 계획입니다.
⚙️ 사용법
Apify MCP 서버는 두 가지 방법으로 사용할 수 있습니다. Apify 플랫폼에서 실행되는 Apify Actor로 사용하거나 , 사용자의 컴퓨터에서 실행되는 로컬 서버 로 사용할 수 있습니다.
🇦 MCP 서버 액터
대기 웹 서버
Actor는 요청을 수신하고 처리하는 HTTP 웹 서버와 함께 대기 모드 에서 실행됩니다.
기본 Actors로 서버를 시작하려면 다음 URL로 Apify API 토큰 과 함께 HTTP GET 요청을 보내세요.
https://actors-mcp-server.apify.actor?token=<APIFY_TOKEN>다른 액터 세트로 MCP 서버를 시작할 수도 있습니다. 이렇게 하려면 작업을 생성하고 사용할 액터 목록을 지정하세요.
그런 다음, 선택한 액터로 대기 모드에서 작업을 실행합니다.
https://USERNAME--actors-mcp-server-task.apify.actor?token=<APIFY_TOKEN>사용 가능한 모든 Actor 목록은 Apify Store 에서 확인할 수 있습니다.
💬 SSE를 통해 MCP 서버와 상호 작용
서버가 실행되면 SSE(Server-Sent Events)를 통해 서버로 메시지를 보내고 응답을 받을 수 있습니다. 가장 쉬운 방법은 Apify에서 Tester MCP Client를 사용하는 것입니다.
Claude Desktop은 현재 SSE를 지원하지 않지만, Stdio 전송과 함께 사용할 수 있습니다. 자세한 내용은 로컬 호스트의 MCP 서버를 참조하세요. 참고: Claude Desktop 무료 버전은 서버와의 간헐적인 연결 문제가 발생할 수 있습니다.
클라이언트 설정에서 서버 구성을 제공해야 합니다.
{
"mcpServers": {
"apify": {
"type": "sse",
"url": "https://actors-mcp-server.apify.actor/sse",
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}또는 clientSse.ts 스크립트를 사용하거나 curl </> 명령을 사용하여 서버를 테스트할 수 있습니다.
다음 URL로 GET 요청을 보내 SSE(Server-Sent-Events)를 시작합니다.
curl https://actors-mcp-server.apify.actor/sse?token=<APIFY_TOKEN>서버는
sessionId로 응답하는데, 이를 사용하여 서버로 메시지를 보낼 수 있습니다.event: endpoint data: /message?sessionId=a1bsessionId사용하여 POST 요청을 만들어 서버에 메시지를 보냅니다.curl -X POST "https://actors-mcp-server.apify.actor/message?token=<APIFY_TOKEN>&session_id=a1b" -H "Content-Type: application/json" -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "arguments": { "searchStringsArray": ["restaurants in San Francisco"], "maxCrawledPlacesPerSearch": 3 }, "name": "lukaskrivka/google-maps-with-contact-details" } }'MCP 서버는 제공된 인수를 입력 매개변수로 사용하여 Actor
lukaskrivka/google-maps-with-contact-details시작합니다. 이 POST 요청에 대해 서버는 다음과 같이 응답합니다.Accepted응답을 수신합니다. 서버는 제공된 쿼리 매개변수를 사용하여 지정된 Actor를 도구로 호출하고 SSE를 통해 클라이언트로 응답을 스트리밍합니다. 응답은 JSON 텍스트로 반환됩니다.
event: message data: {"result":{"content":[{"type":"text","text":"{\"searchString\":\"restaurants in San Francisco\",\"rank\":1,\"title\":\"Gary Danko\",\"description\":\"Renowned chef Gary Danko's fixed-price menus of American cuisine ... \",\"price\":\"$100+\"...}}]}}
⾕ 로컬 호스트의 MCP 서버
Claude Desktop이나 다른 MCP 클라이언트를 사용하여 로컬 컴퓨터에서 Apify MCP 서버를 실행할 수 있습니다. Smithery를 사용하여 서버를 자동으로 설치할 수도 있습니다.
필수 조건
MacOS 또는 Windows
Claude Desktop의 최신 버전을 설치해야 합니다(또는 다른 MCP 클라이언트)
Node.js (v18 이상)
Apify API 토큰 (
APIFY_TOKEN)
node 와 npx 제대로 설치되었는지 확인하세요.
node -v
npx -v그렇지 않은 경우, Node.js를 설치하려면 이 가이드를 따르세요: Node.js와 npm 다운로드 및 설치 .
클로드 데스크탑
MCP 서버와 함께 작동하도록 Claude Desktop을 구성하려면 다음 단계를 따르세요. 자세한 내용은 Claude Desktop 사용자 가이드를 참조하거나 비디오 자습서를 시청하세요.
데스크톱용 Claude 다운로드
Windows 및 macOS에서 사용 가능합니다.
Linux 사용자의 경우 이 비공식 빌드 스크립트를 사용하여 Debian 패키지를 빌드할 수 있습니다.
Claude Desktop 앱을 열고 왼쪽 상단 메뉴 표시줄에서 개발자 모드를 활성화하세요.
이 기능을 활성화한 후 설정을 열고(왼쪽 상단 메뉴 표시줄에서도 가능) 개발자 옵션 으로 이동하면 구성 편집 버튼을 찾을 수 있습니다.
구성 파일을 열고 다음 파일을 편집하세요.
macOS의 경우:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows의 경우:
%APPDATA%/Claude/claude_desktop_config.jsonLinux의 경우:
~/.config/Claude/claude_desktop_config.json
{ "mcpServers": { "actors-mcp-server": { "command": "npx", "args": ["-y", "@apify/actors-mcp-server"], "env": { "APIFY_TOKEN": "your-apify-token" } } } }또는
actors인수를 사용하여 하나 이상의 Apify Actor를 선택할 수 있습니다.{ "mcpServers": { "actors-mcp-server": { "command": "npx", "args": [ "-y", "@apify/actors-mcp-server", "--actors", "lukaskrivka/google-maps-with-contact-details,apify/instagram-scraper" ], "env": { "APIFY_TOKEN": "your-apify-token" } } } }Claude Desktop을 다시 시작하세요
Claude Desktop을 완전히 종료합니다(최소화되거나 닫힌 상태가 아닌지 확인하세요).
Claude Desktop을 다시 시작합니다.
Actors MCP 서버가 연결되었는지 확인하려면 🔌 아이콘을 찾으세요.
Claude Desktop 채팅을 열고 "어떤 Apify Actor를 사용할 수 있나요?"라고 물어보세요.

예시
Claude에게 다음과 같은 작업을 수행하도록 요청할 수 있습니다.
Find and analyze recent research papers about LLMs. Find the top 10 best Italian restaurants in San Francisco. Find and analyze the Instagram profile of The Rock.
VS 코드
한 번의 클릭으로 설치하려면 아래 설치 버튼 중 하나를 클릭하세요.
수동 설치
VS Code에서 Apify MCP 서버를 수동으로 설치할 수 있습니다. 먼저, 이 섹션 상단의 설치 버튼 중 하나를 클릭하여 원클릭으로 설치하세요.
또는 VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가합니다. Ctrl + Shift + P 를 누르고 Preferences: Open User Settings (JSON) 입력하면 됩니다.
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "apify_token",
"description": "Apify API Token",
"password": true
}
],
"servers": {
"actors-mcp-server": {
"command": "npx",
"args": ["-y", "@apify/actors-mcp-server"],
"env": {
"APIFY_TOKEN": "${input:apify_token}"
}
}
}
}
}선택적으로, 작업 공간의 .vscode/mcp.json 파일에 추가할 수 있습니다. 최상위 키인 mcp {} 만 생략하면 됩니다. 이렇게 하면 다른 사용자와 구성을 공유할 수 있습니다.
로드할 Actor를 지정하려면 --actors 인수를 추가할 수 있습니다.
{
"servers": {
"actors-mcp-server": {
"command": "npx",
"args": [
"-y", "@apify/actors-mcp-server",
"--actors", "lukaskrivka/google-maps-with-contact-details,apify/instagram-scraper"
],
"env": {
"APIFY_TOKEN": "${input:apify_token}"
}
}
}
}VS 코드
한 번의 클릭으로 설치하려면 아래 설치 버튼 중 하나를 클릭하세요.
수동 설치
VS Code에서 Apify MCP 서버를 수동으로 설치할 수 있습니다. 먼저, 이 섹션 상단의 설치 버튼 중 하나를 클릭하여 원클릭으로 설치하세요.
또는 VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가합니다. Ctrl + Shift + P 를 누르고 Preferences: Open User Settings (JSON) 입력하면 됩니다.
{
"mcp": {
"inputs": [
{
"type": "promptString",
"id": "apify_token",
"description": "Apify API Token",
"password": true
}
],
"servers": {
"actors-mcp-server": {
"command": "npx",
"args": ["-y", "@apify/actors-mcp-server"],
"env": {
"APIFY_TOKEN": "${input:apify_token}"
}
}
}
}
}선택적으로, 작업 공간의 .vscode/mcp.json 파일에 추가할 수 있습니다. 최상위 키인 mcp {} 만 생략하면 됩니다. 이렇게 하면 다른 사용자와 구성을 공유할 수 있습니다.
로드할 Actor를 지정하려면 --actors 인수를 추가할 수 있습니다.
{
"servers": {
"actors-mcp-server": {
"command": "npx",
"args": [
"-y", "@apify/actors-mcp-server",
"--actors", "lukaskrivka/google-maps-with-contact-details,apify/instagram-scraper"
],
"env": {
"APIFY_TOKEN": "${input:apify_token}"
}
}
}
}@modelcontextprotocol/inspector를 사용하여 NPM 패키지 @apify/actors-mcp-server 디버깅
서버를 디버깅하려면 MCP Inspector 도구를 사용하세요.
export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector npx -y @apify/actors-mcp-serverSmithery를 통해 설치
Smithery를 통해 Claude Desktop에 Apify Actors MCP 서버를 자동으로 설치하려면:
npx -y @smithery/cli install @apify/actors-mcp-server --client claudeStdio 클라이언트
다음 내용으로 환경 파일 .env 를 만듭니다.
APIFY_TOKEN=your-apify-tokenexamples 디렉토리에서 표준 입출력(stdio)을 통해 서버와 상호 작용하는 예제 클라이언트를 찾을 수 있습니다.
clientStdio.ts이 클라이언트 스크립트는 지정된 두 액터로 MCP 서버를 시작합니다. 그런 다음 쿼리를 사용하여apify/rag-web-browser도구를 호출하고 결과를 출력합니다. MCP 서버에 연결하고, 사용 가능한 도구를 나열하고, stdio 전송을 사용하여 특정 도구를 호출하는 방법을 보여줍니다.node dist/examples/clientStdio.js
👷🏼 개발
필수 조건
Node.js (v18 이상)
파이썬 3.9 이상
다음 내용으로 환경 파일 .env 를 만듭니다.
APIFY_TOKEN=your-apify-tokenactor-mcp-server 패키지를 빌드합니다.
npm run build로컬 클라이언트(SSE)
SSE 전송을 사용하여 서버를 테스트하려면 스크립트 examples/clientSse.ts 사용할 수 있습니다. 현재 Node.js 클라이언트는 사용자 지정 헤더를 사용하여 원격 서버에 연결하는 기능을 지원하지 않습니다. 스크립트에서 URL을 로컬 서버 URL로 변경해야 합니다.
node dist/examples/clientSse.js디버깅
MCP 서버는 표준 입출력(stdio)을 통해 작동하므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector를 사용하세요.
다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.
export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector node ./dist/stdio.jsInspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.
ⓘ 제한 사항 및 피드백
Actor 입력 스키마는 JSON 스키마 표준을 준수하는 동시에 대부분의 MCP 클라이언트와 호환되도록 처리됩니다. 처리 과정은 다음과 같습니다.
설명은 500자(
MAX_DESCRIPTION_LENGTH에 정의된 대로)로 잘립니다.열거형 필드는 모든 요소에 대해 최대 200자의 결합 길이로 잘립니다(
ACTOR_ENUM_MAX_LENGTH에 정의된 대로).필수 필드는 JSON 스키마를 제대로 처리하지 못할 수 있는 프레임워크와의 호환성을 위해 설명에 "필수" 접두사로 명시적으로 표시됩니다.
중첩된 속성은 프록시 구성 및 요청 목록 소스와 같은 특수한 경우에 맞게 작성되어 올바른 입력 구조를 보장합니다.
스키마에 명시적으로 정의되지 않은 경우 배열 항목 유형은 다음 우선순위에 따라 추론됩니다. 항목의 명시적 유형 > 사전 채우기 유형 > 기본값 유형 > 편집기 유형.
클라이언트가 JSON 스키마를 완벽하게 지원하지 않더라도 가시성을 보장하기 위해 속성 설명에 열거형 값과 예제가 추가되었습니다.
각 Actor의 메모리는 4GB로 제한됩니다. 무료 사용자는 8GB로 제한되며, Actors-MCP-Server 실행에는 128MB가 할당되어야 합니다.
다른 기능이 필요하거나 피드백이 있으시면 Apify 콘솔에서 문제를 제출하여 알려주세요.
🚀 로드맵 (2025년 3월)
Apify의 데이터 세트와 키-값 저장소를 리소스로 추가합니다.
디버깅을 위해 Actor 로그 및 Actor 실행과 같은 도구를 추가합니다.
🐛 문제 해결
node -v실행하여node설치되었는지 확인하세요.APIFY_TOKEN환경 변수가 설정되어 있는지 확인하세요.@apify/actors-mcp-server@latest설정하여 항상 최신 버전의 MCP 서버를 사용하세요.
📚 자세히 알아보기
Available Tools
13 toolsabort-actor-runAbort Actor runADestructiveIdempotentInspect
Abort an Actor run that is currently starting or running. For runs with status SUCCEEDED, FAILED, ABORTING, ABORTED, or TIMED-OUT, this call has no effect. The results will include the updated run details after the abort request.
USAGE:
Use when you need to stop a run that is taking too long or misconfigured.
USAGE EXAMPLES:
user_input: Abort run y2h7sK3Wc
user_input: Gracefully abort run y2h7sK3Wc
Inputs: runId (required), gracefully. Returns: tip, runId, stats, status, +10 more
call-actorCall ActorADestructiveInspect
Call any Actor from the Apify Store.
WORKFLOW:
Use fetch-actor-details to get the Actor's input schema
Call this tool with the actor name and proper input based on the schema
If the actor name is not in "username/name" format, use search-actors to resolve the correct Actor first.
An MCP server Actor with no input schema is not run here; call-actor-mcp-tool calls its MCP tools.
For Server Actors (Actors with an HTTP API):
This tool starts a batch run and stores the results in a dataset; use it when you need batch results
For one or a few results, send-server-actor-request returns them in the HTTP response, without a batch run
fetch-actor-details with output={ serverInterface: true } lists its HTTP operations
IMPORTANT:
Waits up to waitSecs (default 30s) for completion; returns run status and storage IDs, and with waitSecs > 0 also reports dataset field metadata
Use get-dataset-items with the datasetId to fetch results; non-terminal runs include a nextStep with polling instructions
There are two ways to use an Actor:
Its dedicated tool, when the session has one: a Server Actor's tool sends one HTTP request to its API, an MCP server Actor's tools call its MCP server, and any other Actor's tool starts a run.
The generic call-actor tool: starts a run of any Actor and stores the results in a dataset.
USAGE:
Prefer the dedicated tool when the session has one for the Actor
call-actor runs an Actor that has no dedicated tool, and batch work whose results belong in a dataset.
Use
waitSecs(0–45) to control how long to wait. Default 30s returns results for fast actors. UsewaitSecs: 0to start and return immediately for long-running actors.
EXAMPLES:
user_input: Get instagram posts using apify/instagram-scraper
Inputs: actor (required), input (required), waitSecs, callOptions. Returns: tip, runId, stats, status, +10 more
call-actor-mcp-toolCall Actor MCP toolADestructiveInspect
Call one tool on an Actor's MCP server and return its result. fetch-actor-mcp-tool-list lists the Actor's MCP tools and their input schemas. It connects with your Apify API token. Connecting can start a Server Actor run in your account, kept until its idle timeout; a multi-tenant Server Actor charges per event. What the tool itself does depends on the Actor.
Example call: {"actor": "username/name", "tool": "search", "arguments": {"query": "apify"}}
USAGE:
Use when the user asks to call a tool on an Actor's MCP server.
USAGE EXAMPLES:
user_input: Use the search tool of username/name to look up apify
Inputs: tool (required), actor (required), arguments.
fetch-actor-detailsFetch Actor detailsARead-onlyIdempotentInspect
Get detailed information about an Actor by its ID or full name (format: "username/name", e.g., "apify/rag-web-browser").
Requires the exact ID or full name — do not construct a plausible-looking name and call this tool with it. If you only have a description, a partial name, or a name you have not seen in this conversation, find it with search-actors first.
Use 'output' to control returned information:
Default: all fields except outputSchema and serverInterface. Server Actors always get a one-line server interface summary unless serverInterface is true or a selector.
Selective: set only the fields you need to true, e.g. output: { inputSchema: true }
Common patterns: inputSchema only, description + readme, serverInterface: true (every operation in full when they fit, an index of them otherwise) or "GET /search" (one operation in full) for Server Actors
The 'readme' field returns the summary when available, full README otherwise. Use when querying Actor details, documentation, or input requirements. It does not connect to an MCP server Actor; fetch-actor-mcp-tool-list lists its MCP tools.
EXAMPLES:
What does apify/web-fetch do?
What is the input schema for apify/web-scraper?
What HTTP operations does this Server Actor expose?
Inputs: actor (required), output. Returns: readme, nextStep, actorInfo, inputSchema, +2 more
fetch-actor-mcp-tool-listFetch Actor MCP tool listAInspect
List an Actor's MCP tools with each tool's name, description, input schema, annotations, and metadata, as the server reports them. call-actor-mcp-tool calls one of them by name. Each call asks the server again; nothing is cached. It connects with your Apify API token. Connecting can start a Server Actor run in your account, kept until its idle timeout; a multi-tenant Server Actor charges per event.
USAGE:
Use when the user asks which MCP tools an Actor provides, or before calling one of them.
USAGE EXAMPLES:
user_input: What tools does username/name provide?
Inputs: actor (required). Returns: tools
fetch-apify-docsFetch Apify docsARead-onlyIdempotentInspect
Fetch the full content of an Apify or Crawlee documentation page by its URL. Use this after finding a relevant page with the search-apify-docs tool.
USAGE:
Use when you need the complete content of a specific docs page for detailed answers.
USAGE EXAMPLES:
user_input: Fetch https://docs.apify.com/platform/actors/running#builds
user_input: Fetch https://docs.apify.com/academy
user_input: Fetch https://crawlee.dev/docs/guides/basic-concepts
Inputs: url (required). Returns: url, content
get-actor-runGet Actor runARead-onlyIdempotentInspect
Get detailed information about a specific Actor run.
Returns run result: status, storages (datasets/keyValueStores alias map), stats, summary, nextStep.
summary describes the past (e.g. "SUCCEEDED in 22s. 47 items; 3 fields available.").
nextStep prescribes one primary follow-up action with identifiers interpolated (e.g. "Use get-dataset-items with datasetId=...").
waitSecs (0–45, default 30) waits up to that many seconds for terminal status before returning.
USAGE:
Use to check the status of a run started by any Actor-running tool.
Pass waitSecs > 0 to block until terminal (or until the cap elapses).
USAGE EXAMPLES:
user_input: Show details of run y2h7sK3Wc
user_input: Wait for run y2h7sK3Wc to finish
Inputs: runId (required), waitSecs. Returns: tip, runId, stats, status, +10 more
get-dataset-itemsGet dataset itemsARead-onlyIdempotentInspect
Get items (rows) from a dataset — the output/results produced by an Actor run. Returns the rows themselves, not dataset metadata, counts, or a schema. When the user provides a datasetId and asks to retrieve results, output, data, or rows, call this tool directly. Default limit is 20. Use clean=true to skip empty items and hidden fields.
USAGE:
Use when you need to read data from a dataset (all items or only selected fields).
USAGE EXAMPLES:
user_input: Retrieve results from dataset abc123
user_input: Get only metadata.url and title from dataset username~my-dataset
Inputs: datasetId (required), desc, omit, clean, +4 more. Returns: items, limit, offset, summary, +5 more
get-key-value-store-recordGet key-value store recordARead-onlyIdempotentInspect
Get the value stored under a specific key in a key-value store — a single record, not a listing of all keys. Requires the exact key name. The response preserves the original Content-Encoding; most clients handle decompression automatically. A record over 262144 bytes is returned as a link to download it, not as its value.
USAGE:
Use when you need to retrieve a specific record (JSON, text, or binary) from a store.
USAGE EXAMPLES:
user_input: Get record INPUT from store abc123
user_input: Get record data.json from store username~my-store
Inputs: recordKey (required), keyValueStoreId (required). Returns: key, value, summary, contentType, +1 more
report-problemReport a problemAInspect
Report a problem with Apify's MCP tools or Actors to the Apify team.
Reports can describe missing tools or Actors, errors, timeouts, confusing results, steps that took several attempts, or tasks that the available tools could not complete. Reports help fix the problem for other users.
Put what you were doing and what went wrong in "message". Do NOT include personal data, credentials, secrets, or verbatim private conversation content — describe the issue in your own words.
Inputs: message (required), actorId, actorRunId, relatedTools. Returns: reported
search-actorsSearch ActorsARead-onlyIdempotentInspect
Search the Apify Store to FIND and DISCOVER what scraping tools/Actors exist for specific platforms or use cases. This tool provides INFORMATION about available Actors - it does NOT retrieve actual data or run any scraping tasks.
Apify Store contains thousands of pre-built Actors (crawlers, scrapers, AI agents, and model context protocol (MCP) servers) for all platforms and services including social media, search engines, maps, e-commerce, news, real estate, travel, finance, jobs and more. Apify Store lists Actors published by Apify and by independent developers.
Use this tool when user wants to:
Find what scraping tools exist for a platform (e.g., "What tools can scrape Instagram?")
Discover available Actors for a use case (e.g., "Find an Actor for Amazon products")
Browse existing solutions (e.g., "Show me scrapers for news sites")
Learn about MCP servers or AI agents available in the Store
This tool discovers Actors; it does not retrieve their output. IMPORTANT: When the user wants detailed data from a specific platform or is looking for scraping tools, prefer searching the Store first — a relevant Actor often already exists. When the user names a specific Actor, look up that Actor directly instead of searching.
Usage:
Use 1-3 simple terms from the platform and/or data type the user named (e.g. "Instagram posts", "Twitter", "Amazon products"). With neither named, empty keywords return the Store's default ordering. A platform-only query is an option if more specific results do not fit.
Important limitations: This tool does not return full Actor documentation or detailed usage instructions - only summary information.
Each result lists the Actor's input fields with their types (e.g. url: string, maxResults?: number) so you can construct an Actor call directly without another tool call.
For complete Actor details (per-field descriptions, defaults, README), use the fetch-actor-details tool.
The search is limited to publicly available Actors and excludes rental and restricted Actors.
Returns list of Actor cards with the following info:
Title: Markdown header linked to the Store page, followed by the full Actor name in code format
URL: Direct Store link
Description: Actor description or fallback
Pricing: Details with pricing link
Stats: Total and monthly users
Rating: Out of 5 (if available)
Developed by: Username linked to profile, marked (Apify) or (community)
Categories: Formatted or "Uncategorized"
Last modified: Date (if available)
Input fields: Inline list of input field names and types (e.g.
url: string, maxResults?: number);?marks optional fields,... (+N more)marks a truncated list
Inputs: limit, offset, useCase, keywords. Returns: count, query, actors, userTier, +1 more
search-apify-docsSearch Apify docsARead-onlyIdempotentInspect
Search Apify and Crawlee documentation using full-text search. Do not also search the Apify Store unless the user asks to find Actors.
You must explicitly select which documentation source to search using the docSource parameter:
• docSource="apify" - Apify: Apify Platform documentation including: Platform features, SDKs (JS, Python), CLI, REST API, Academy (web scraping fundamentals), Actor development and deployment
• docSource="crawlee-js" - Crawlee (JavaScript): Crawlee is a web scraping library for JavaScript. It handles blocking, crawling, proxies, and browsers for you.
• docSource="crawlee-py" - Crawlee (Python): Crawlee is a web scraping library for Python. It handles blocking, crawling, proxies, and browsers for you.
The results will include the URL of the documentation page (which may include an anchor), and a limited piece of content that matches the search query.
Fetch the full content of the document using the fetch-apify-docs tool by providing the URL.
When results contain both platform documentation (docs.apify.com/platform) and Academy content (docs.apify.com/academy) on the same topic, prefer the platform documentation.
Inputs: query (required), limit, offset, docSource. Returns: results, instructions
send-server-actor-requestSend Server Actor requestADestructiveInspect
Send one HTTP request to an Actor Server: the HTTP API of a Server Actor, documented in its API schema (OpenAPI) and README. fetch-actor-details with output.serverInterface returns the documented operations with their parameters. Give the method, the path, and optionally query parameters and a JSON body; the Actor Server's host and your Apify API token are added for you. Only an Actor with an Actor Server and an API schema takes requests here; the Actor accepts or rejects the method and path. A request to a single-tenant Actor Server can start a run of the Actor in your account, kept until its idle timeout; a multi-tenant Actor Server charges per event. The request is sent once, with no retries and without following redirects. A JSON, text, or XML response body is returned as text, cut at 262144 bytes; other content types are not returned.
Example call: {"actor": "apify/rag-web-browser", "method": "GET", "path": "/search", "query": {"query": "AI news", "maxResults": 3}}
USAGE:
Use when the Actor that fits the user's request has an Actor Server, and its API schema or README names the endpoint for the task.
Fits requests for one or a few results returned in the HTTP response. Larger batches depend on the endpoint and the response size and time limits.
USAGE EXAMPLES:
user_input: Search the web for the latest AI news and read the top pages with apify/rag-web-browser
user_input: Read https://docs.apify.com as Markdown with apify/rag-web-browser
Inputs: path (required), actor (required), method (required), body, +1 more. Returns: body, path, bytes, method, +13 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Most tools target clearly distinct actions (search, fetch details, run, abort, read dataset, docs search/fetch). The only murky cluster is call-actor vs call-actor-mcp-tool vs send-server-actor-request, which all 'invoke' something, but the descriptions clearly differentiate generic runs, MCP tool calls, and HTTP endpoint requests.
All 13 tools use consistent kebab-case verb-first naming: fetch-*, search-*, get-*, call-*, abort-*, send-*, report-*. No mixing of conventions or casing styles.
13 tools sits squarely in the well-scoped range for an Actor hub that must cover discovery, execution, storage retrieval, docs, and reporting. Each tool maps to a distinct step in the workflow.
The surface covers the full Actor lifecycle (discover, inspect, run, poll, abort) plus dataset and key-value access, docs, MCP tool invocation, server HTTP requests, and problem reporting. Minor gaps remain: no listing of a user's own runs/actors or dataset/key-value-store enumeration, though agents can work around these with known IDs.
Maintenance
Related MCP Connectors
No-code web scraping & data-extraction Apify actors: scrape and enrich web data at scale.
No-code web scraping & data-extraction Apify actors: scrape and enrich web data at scale.
Pay-per-use Apify tools for AI classification, SEO audits, leads, transcripts and web data.
64 public Apify Actors for public-record, jobs, lead, SEO and social data, as MCP tools.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceExposes over 19,000 Apify Actors as MCP tools for web scraping, data extraction, and OSINT automation. It enables AI agents to dynamically discover and execute scrapers to collect structured data and crawl web content.MIT
- AlicenseNot gradedqualityDmaintenanceEnables web scraping, browser automation, and dataset management through Apify's actor platform.MIT
- AlicenseAqualityBmaintenance35 public-data MCP tools with optional focused profiles for business leads, market intelligence, government records, and research/health. Includes Maps, jobs, SEC filings, grants, sanctions and more. Runs use your own Apify account and are billed there. Structured results and deterministic errors.43MIT

honestkit-mcpofficial
AlicenseNot gradedqualityBmaintenanceEnables AI agents to access fourteen web-data tools for scraping, SEO and site auditing, extraction, validation, enrichment, and screenshots through Apify actors. It runs those tools on the user's own Apify account via an API token.MIT