actors-mcp-server
OfficialСервер протокола контекста модели Apify (MCP)
Реализация сервера MCP для всех субъектов Apify . Этот сервер обеспечивает взаимодействие с одним или несколькими субъектами Apify, которые могут быть определены в конфигурации сервера MCP.
Сервер можно использовать двумя способами:
🇦 MCP Server Actor – HTTP-сервер, доступный через Server-Sent Events (SSE), см. руководство
⾕ MCP Server Stdio – Локальный сервер доступен через стандартный ввод/вывод (stdio), см. руководство
Вы также можете взаимодействовать с сервером MCP, используя пользовательский интерфейс в виде чата с помощью 💬 Tester MCP Client
🎯 Что делает сервер Apify MCP?
MCP Server Actor позволяет помощнику AI использовать любого Apify Actor в качестве инструмента для выполнения определенной задачи. Например, он может:
Используйте Facebook Posts Scraper для извлечения данных из постов Facebook с нескольких страниц/профилей.
Используйте Google Maps Email Extractor для извлечения контактных данных из Google Maps
Используйте Google Search Results Scraper для сбора страниц результатов поиска Google (SERP)
Используйте Instagram Scraper для сбора данных из постов, профилей, мест, фотографий и комментариев в Instagram.
Используйте веб-браузер RAG для поиска в Интернете, извлечения N самых популярных URL-адресов и возврата их содержимого.
Клиенты МКП
Для взаимодействия с сервером Apify MCP вы можете использовать такие клиенты MCP, как:
Claude Desktop (поддержка только Stdio)
Visual Studio Code (поддержка Stdio и SSE)
LibreChat (поддержка Stdio и SSE, но без заголовка Authorization)
Клиент Apify Tester MCP (поддержка SSE с заголовками авторизации)
Другие клиенты на https://modelcontextprotocol.io/clients
Больше клиентов на https://glama.ai/mcp/clients
Когда Actors интегрирован с сервером MCP, вы можете задать следующие вопросы:
«Поиск в Интернете и обобщение последних тенденций в области агентов ИИ»
«Найдите 10 лучших итальянских ресторанов в Сан-Франциско»
«Найдите и проанализируйте профиль The Rock в Instagram»
«Предоставьте пошаговое руководство по использованию протокола контекста модели с исходными URL-адресами»
«Какие актеры Apify я могу использовать?»
На следующем изображении показано, как сервер Apify MCP взаимодействует с платформой Apify и клиентами ИИ:

С клиентом MCP Tester вы можете загружать актеров динамически, но это пока не поддерживается другими клиентами MCP. Мы также планируем добавить больше функций, см. Дорожную карту для получения более подробной информации.
🔄 Что такое протокол контекста модели?
Протокол контекста модели (MCP) позволяет приложениям ИИ (и агентам ИИ), таким как Claude Desktop, подключаться к внешним инструментам и источникам данных. MCP — это открытый протокол, который обеспечивает безопасное, контролируемое взаимодействие между приложениями ИИ, агентами ИИ и локальными или удаленными ресурсами.
Более подробную информацию можно найти на веб-сайте Model Context Protocol или в записи блога Что такое MCP и почему это важно?.
🤖 Как MCP Server связан с AI Agents?
Сервер Apify MCP предоставляет доступ к акторам Apify через протокол MCP, позволяя агентам ИИ или фреймворкам, реализующим протокол MCP, получать доступ ко всем акторам Apify в качестве инструментов для извлечения данных, веб-поиска и других задач.
Чтобы узнать больше об агентах ИИ, изучите нашу запись в блоге: Что такое агенты ИИ? и просмотрите подобранную коллекцию агентов ИИ Apify. Хотите создать и монетизировать своего собственного агента ИИ на Apify? Ознакомьтесь с нашим пошаговым руководством по созданию, публикации и монетизации агентов ИИ на платформе Apify.
🧱 Компоненты
Инструменты
Актеры
Любой актер Apify может быть использован в качестве инструмента. По умолчанию сервер предварительно настроен с указанными ниже актерами, но это можно переопределить, предоставив входные данные актера.
'apify/instagram-scraper'
'apify/rag-web-browser'
'lukaskrivka/google-maps-with-contact-details'Сервер MCP загружает входную схему Actor и создает инструменты MCP, соответствующие Actors. Смотрите этот пример входной схемы для веб-браузера RAG .
Имя инструмента всегда должно быть полным именем Актера, например apify/rag-web-browser . Аргументы для инструмента MCP представляют входные параметры Актера. Например, для Актера apify/rag-web-browser аргументы следующие:
{
"query": "restaurants in San Francisco",
"maxResults": 3
}Вам не нужно указывать входные параметры или какой Actor вызывать; всем управляет LLM. Когда вызывается инструмент, аргументы автоматически передаются Actor от LLM. Вы можете обратиться к документации конкретного Actor для получения списка доступных аргументов.
Вспомогательные инструменты
Сервер предоставляет набор вспомогательных инструментов для обнаружения доступных Актеров и получения их данных:
get-actor-details: извлекает документацию, входную схему и сведения о конкретном Актере.discover-actors: ищет соответствующих актеров по ключевым словам и возвращает их данные.
Также имеются инструменты для управления списком доступных инструментов. Однако динамическое добавление и удаление инструментов требует, чтобы клиент MCP имел возможность обновлять список инструментов (обрабатывать ToolListChangedNotificationSchema ), что обычно не поддерживается.
Вы можете попробовать эту функциональность с помощью Apify Tester MCP Client Actor. Чтобы включить ее, установите параметр enableAddingActors .
add-actor-as-tool: добавляет актера по имени в список доступных инструментов, не выполняя его, требуя согласия пользователя для последующего запуска.remove-actor-from-tool: удаляет актера по имени из списка доступных инструментов, когда он больше не нужен.
Related MCP server: Apify MCP Server
Подсказка и ресурсы
Сервер не предоставляет никаких ресурсов и подсказок. Мы планируем добавить набор данных Apify и хранилище ключей и значений в качестве ресурсов в будущем.
⚙️ Использование
Сервер Apify MCP можно использовать двумя способами: как субъект Apify, работающий на платформе Apify, или как локальный сервер , работающий на вашем компьютере.
🇦 MCP Сервер Актер
Резервный веб-сервер
Actor работает в режиме ожидания с HTTP-веб-сервером, который принимает и обрабатывает запросы.
Чтобы запустить сервер с акторами по умолчанию, отправьте HTTP-запрос GET с вашим токеном API Apify на следующий URL-адрес:
https://actors-mcp-server.apify.actor?token=<APIFY_TOKEN>Также возможно запустить сервер MCP с другим набором Актеров. Для этого создайте задачу и укажите список Актеров, которых вы хотите использовать.
Затем запустите задачу в режиме ожидания с выбранными участниками:
https://USERNAME--actors-mcp-server-task.apify.actor?token=<APIFY_TOKEN>Список всех доступных актеров можно найти в магазине Apify .
💬 Взаимодействие с сервером MCP через SSE
После запуска сервера вы можете взаимодействовать с Server-Sent Events (SSE) для отправки сообщений на сервер и получения ответов. Самый простой способ — использовать Tester MCP Client на Apify.
В настоящее время Claude Desktop не поддерживает SSE, но вы можете использовать его с транспортом Stdio; см . MCP Server на локальном хосте для получения более подробной информации. Примечание: бесплатная версия Claude Desktop может испытывать периодические проблемы с подключением к серверу.
В настройках клиента необходимо указать конфигурацию сервера:
{
"mcpServers": {
"apify": {
"type": "sse",
"url": "https://actors-mcp-server.apify.actor/sse",
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}В качестве альтернативы вы можете использовать скрипт clientSse.ts или протестировать сервер с помощью команд curl </>.
Инициируйте Server-Sent-Events (SSE), отправив запрос GET на следующий URL:
curl https://actors-mcp-server.apify.actor/sse?token=<APIFY_TOKEN>Сервер ответит
sessionId, который можно использовать для отправки сообщений на сервер:event: endpoint data: /message?sessionId=a1bОтправьте сообщение на сервер, выполнив POST-запрос с
sessionId: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-сервер на локальном хосте
Вы можете запустить Apify MCP Server на локальной машине, настроив его с помощью Claude Desktop или любого другого клиента MCP . Вы также можете использовать Smithery для автоматической установки сервера.
Предпосылки
MacOS или Windows
Должна быть установлена последняя версия Claude Desktop (или другой клиент MCP)
Node.js (v18 или выше)
API-токен Apify (
APIFY_TOKEN)
Убедитесь, что у вас правильно установлены node и npx :
node -v
npx -vЕсли нет, следуйте этому руководству по установке Node.js: Загрузка и установка Node.js и npm .
Клод Десктоп
Чтобы настроить Claude Desktop для работы с сервером MCP, выполните следующие шаги. Для подробного руководства обратитесь к Claude Desktop User Guide или посмотрите видеоурок .
Скачать Клод для рабочего стола
Доступно для Windows и macOS.
Пользователи Linux могут собрать пакет Debian, используя этот неофициальный скрипт сборки .
Откройте приложение Claude Desktop и включите режим разработчика в верхней левой строке меню.
После включения откройте «Настройки» (также из верхней левой панели меню) и перейдите в раздел « Параметры разработчика» , где вы найдете кнопку «Изменить конфигурацию» .
Откройте файл конфигурации и отредактируйте следующий файл:
На macOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonВ Windows:
%APPDATA%/Claude/claude_desktop_config.jsonВ Linux:
~/.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:{ "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.
Найдите значок 🔌, чтобы подтвердить, что сервер Actors MCP подключен.
Откройте чат Claude Desktop и спросите: «Какие актеры Apify я могу использовать?»

Примеры
Вы можете попросить Клода выполнить такие задания, как:
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
Для установки в один клик нажмите одну из кнопок установки ниже:
Ручная установка
Вы можете вручную установить Apify MCP Server в VS Code. Сначала нажмите одну из кнопок установки в верхней части этого раздела для установки в один клик.
В качестве альтернативы добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав 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 {} . Это позволит вам поделиться конфигурацией с другими.
Если вы хотите указать, какие актеры следует загрузить, вы можете добавить аргумент --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
Для установки в один клик нажмите одну из кнопок установки ниже:
Ручная установка
Вы можете вручную установить Apify MCP Server в VS Code. Сначала нажмите одну из кнопок установки в верхней части этого раздела для установки в один клик.
В качестве альтернативы добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав 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 {} . Это позволит вам поделиться конфигурацией с другими.
Если вы хотите указать, какие актеры следует загрузить, вы можете добавить аргумент --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}"
}
}
}
}Отладка пакета NPM @apify/actors-mcp-server с помощью @modelcontextprotocol/inspector
Для отладки сервера используйте инструмент MCP Inspector :
export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector npx -y @apify/actors-mcp-serverУстановка через Smithery
Чтобы автоматически установить Apify Actors MCP Server для Claude Desktop через Smithery :
npx -y @smithery/cli install @apify/actors-mcp-server --client claudeКлиенты Stdio
Создайте файл среды .env со следующим содержимым:
APIFY_TOKEN=your-apify-tokenВ каталоге examples вы можете найти пример клиента для взаимодействия с сервером через стандартный ввод/вывод (stdio):
clientStdio.tsЭтот клиентский скрипт запускает сервер MCP с двумя указанными Actors. Затем он вызывает инструментapify/rag-web-browserс запросом и выводит результат. Он демонстрирует, как подключиться к серверу MCP, составить список доступных инструментов и вызвать определенный инструмент с помощью транспорта stdio.node dist/examples/clientStdio.js
👷🏼 Разработка
Предпосылки
Node.js (v18 или выше)
Python 3.9 или выше
Создайте файл среды .env со следующим содержимым:
APIFY_TOKEN=your-apify-tokenСоберите пакет actor-mcp-server:
npm run buildЛокальный клиент (SSE)
Для тестирования сервера с транспортом SSE можно использовать скрипт examples/clientSse.ts : В настоящее время клиент Node.js не поддерживает установление соединения с удаленным сервером с пользовательскими заголовками. Вам необходимо изменить URL на URL вашего локального сервера в скрипте.
node dist/examples/clientSse.jsОтладка
Поскольку серверы MCP работают через стандартный ввод/вывод (stdio), отладка может быть сложной. Для лучшего опыта отладки используйте MCP Inspector .
Вы можете запустить MCP Inspector через npm с помощью этой команды:
export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector node ./dist/stdio.jsПосле запуска Инспектор отобразит URL-адрес, к которому вы можете перейти в своем браузере, чтобы начать отладку.
ⓘ Ограничения и обратная связь
Схема ввода Actor обрабатывается для совместимости с большинством клиентов MCP, придерживаясь стандартов JSON Schema . Обработка включает:
Описания обрезаются до 500 символов (как определено в
MAX_DESCRIPTION_LENGTH).Поля перечисления усекаются до максимальной общей длины 200 символов для всех элементов (как определено в
ACTOR_ENUM_MAX_LENGTH).Обязательные поля явно помечены префиксом «REQUIRED» в своих описаниях для совместимости с фреймворками, которые могут некорректно обрабатывать схему JSON.
Вложенные свойства создаются для особых случаев, таких как конфигурация прокси-сервера и источники списка запросов, чтобы обеспечить правильную структуру входных данных.
Типы элементов массива выводятся, если они явно не определены в схеме, с использованием порядка приоритетов: явный тип в элементах > тип предварительного заполнения > тип значения по умолчанию > тип редактора.
Значения перечисления и примеры добавляются к описаниям свойств, чтобы обеспечить видимость, даже если клиент не полностью поддерживает схему JSON.
Память для каждого Актера ограничена 4 ГБ. Бесплатные пользователи имеют ограничение в 8 ГБ, 128 МБ необходимо выделить для запуска Actors-MCP-Server .
Если вам нужны другие функции или у вас есть какие-либо отзывы, отправьте сообщение о проблеме в консоли Apify, чтобы сообщить нам.
🚀 Дорожная карта (март 2025 г.)
Добавьте набор данных Apify и хранилище «ключ-значение» в качестве ресурсов.
Добавьте такие инструменты, как журналы Actor и запуски Actor для отладки.
🐛 Устранение неполадок
Убедитесь, что у вас установлен
node, запустивnode -vУбедитесь, что у вас установлена переменная среды
APIFY_TOKENВсегда используйте последнюю версию сервера MCP, установив
@apify/actors-mcp-server@latest
📚 Узнать больше
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