actors-mcp-server
OfficialServidor de protocolo de contexto de modelo (MCP) de Apify
Implementación de un servidor MCP para todos los actores de Apify . Este servidor permite la interacción con uno o más actores de Apify, definidos en la configuración del servidor MCP.
El servidor se puede utilizar de dos maneras:
🇦 Actor de servidor MCP : servidor HTTP accesible a través de eventos enviados por el servidor (SSE), consulte la guía
⾕ MCP Server Stdio : servidor local disponible a través de entrada/salida estándar (stdio), consulte la guía
También puedes interactuar con el servidor MCP mediante una interfaz de usuario tipo chat con 💬 Tester MCP Client
🎯 ¿Qué hace el servidor MCP de Apify?
El Actor de Servidor MCP permite que un asistente de IA utilice cualquier Actor de Apify como herramienta para realizar una tarea específica. Por ejemplo, puede:
Utilice Facebook Posts Scraper para extraer datos de publicaciones de Facebook de varias páginas/perfiles
Utilice Google Maps Email Extractor para extraer detalles de contacto de Google Maps
Utilice Google Search Results Scraper para rastrear las páginas de resultados del motor de búsqueda de Google (SERP)
Utilice Instagram Scraper para extraer información de publicaciones, perfiles, lugares, fotos y comentarios de Instagram.
Utilice el navegador web RAG para buscar en la web, extraer las N URL principales y devolver su contenido
Clientes de MCP
Para interactuar con el servidor MCP de Apify, puede utilizar clientes MCP como:
Claude Desktop (solo compatible con Stdio)
Visual Studio Code (compatibilidad con Stdio y SSE)
LibreChat (compatible con Stdio y SSE, pero sin encabezado de autorización)
Cliente MCP de Apify Tester (compatibilidad con SSE y encabezados de autorización)
Otros clientes en https://modelcontextprotocol.io/clients
Más clientes en https://glama.ai/mcp/clients
Cuando tengas Actores integrados con el servidor MCP, podrás preguntar:
Busque en la web y resuma las tendencias recientes sobre los agentes de IA.
Encuentra los 10 mejores restaurantes italianos de San Francisco.
Encuentra y analiza el perfil de Instagram de The Rock.
Proporcionar una guía paso a paso sobre el uso del Protocolo de Contexto de Modelo con URL de origen.
¿Qué actores de Apify puedo utilizar?
La siguiente imagen muestra cómo el servidor Apify MCP interactúa con la plataforma Apify y los clientes de IA:

Con el cliente MCP Tester, puede cargar actores dinámicamente, pero otros clientes MCP aún no lo admiten. También planeamos añadir más funciones; consulte la hoja de ruta para obtener más detalles.
🔄¿Qué es el Protocolo de Contexto Modelo?
El Protocolo de Contexto de Modelo (MCP) permite que las aplicaciones de IA (y sus agentes), como Claude Desktop, se conecten a herramientas y fuentes de datos externas. MCP es un protocolo abierto que facilita interacciones seguras y controladas entre aplicaciones de IA, agentes de IA y recursos locales o remotos.
Para obtener más información, consulte el sitio web del Protocolo de Contexto de Modelo o la publicación del blog ¿Qué es MCP y por qué es importante?
🤖 ¿Cómo se relaciona MCP Server con los agentes de IA?
El servidor MCP de Apify expone los actores de Apify a través del protocolo MCP, lo que permite que los agentes de IA o los marcos que implementan el protocolo MCP accedan a todos los actores de Apify como herramientas para la extracción de datos, la búsqueda web y otras tareas.
Para obtener más información sobre los agentes de IA, consulta nuestra entrada de blog: ¿Qué son los agentes de IA? y explora la colección de agentes de IA de Apify. ¿Te interesa crear y monetizar tu propio agente de IA en Apify? Consulta nuestra guía paso a paso para crear, publicar y monetizar agentes de IA en la plataforma Apify.
🧱 Componentes
Herramientas
Actores
Cualquier actor de Apify puede usarse como herramienta. De forma predeterminada, el servidor está preconfigurado con los actores especificados a continuación, pero esto puede anularse proporcionando la entrada del actor.
'apify/instagram-scraper'
'apify/rag-web-browser'
'lukaskrivka/google-maps-with-contact-details'El servidor MCP carga el esquema de entrada del actor y crea las herramientas MCP correspondientes. Vea este ejemplo de esquema de entrada para el navegador web RAG .
El nombre de la herramienta siempre debe ser el nombre completo del actor, como apify/rag-web-browser . Los argumentos de una herramienta MCP representan los parámetros de entrada del actor. Por ejemplo, para el actor apify/rag-web-browser , los argumentos son:
{
"query": "restaurants in San Francisco",
"maxResults": 3
}No es necesario especificar los parámetros de entrada ni a qué actor llamar; todo lo gestiona un LLM. Al llamar a una herramienta, el LLM pasa automáticamente los argumentos al actor. Puede consultar la documentación específica del actor para obtener una lista de los argumentos disponibles.
Herramientas de ayuda
El servidor proporciona un conjunto de herramientas útiles para descubrir actores disponibles y recuperar sus detalles:
get-actor-details: recupera documentación, esquema de entrada y detalles sobre un actor específico.discover-actors: busca actores relevantes utilizando palabras clave y devuelve sus detalles.
También existen herramientas para administrar la lista de herramientas disponibles. Sin embargo, agregar y eliminar herramientas dinámicamente requiere que el cliente MCP tenga la capacidad de actualizar la lista de herramientas (manejar ToolListChangedNotificationSchema ), lo cual no suele ser compatible.
Puedes probar esta funcionalidad con el actor cliente MCP de Apify Tester . Para habilitarla, configura el parámetro enableAddingActors .
add-actor-as-tool: agrega un actor por nombre a la lista de herramientas disponibles sin ejecutarlo, requiriendo el consentimiento del usuario para ejecutarlo más tarde.remove-actor-from-tool: elimina un actor por nombre de la lista de herramientas disponibles cuando ya no es necesario.
Related MCP server: Apify MCP Server
Aviso y recursos
El servidor no proporciona recursos ni solicitudes. Planeamos agregar el conjunto de datos de Apify y el almacén de claves-valor como recursos en el futuro.
⚙️ Uso
El servidor Apify MCP se puede utilizar de dos maneras: como un actor Apify que se ejecuta en la plataforma Apify o como un servidor local que se ejecuta en su máquina.
Actor de servidor MCP
Servidor web en espera
El actor se ejecuta en modo de espera con un servidor web HTTP que recibe y procesa solicitudes.
Para iniciar el servidor con actores predeterminados, envíe una solicitud HTTP GET con su token de API de Apify a la siguiente URL:
https://actors-mcp-server.apify.actor?token=<APIFY_TOKEN>También es posible iniciar el servidor MCP con un conjunto diferente de actores. Para ello, cree una tarea y especifique la lista de actores que desea utilizar.
Luego, ejecute la tarea en modo de espera con los actores seleccionados:
https://USERNAME--actors-mcp-server-task.apify.actor?token=<APIFY_TOKEN>Puede encontrar una lista de todos los actores disponibles en Apify Store .
💬 Interactúe con el servidor MCP a través de SSE
Una vez que el servidor esté en funcionamiento, puede interactuar con los Eventos Enviados por el Servidor (SSE) para enviar mensajes al servidor y recibir respuestas. La forma más sencilla es usar el Cliente Tester MCP en Apify.
Claude Desktop actualmente no es compatible con SSE, pero puede usarlo con el transporte Stdio; consulte Servidor MCP en un host local para más detalles. Nota: La versión gratuita de Claude Desktop puede experimentar problemas de conexión intermitentes con el servidor.
En la configuración del cliente, debe proporcionar la configuración del servidor:
{
"mcpServers": {
"apify": {
"type": "sse",
"url": "https://actors-mcp-server.apify.actor/sse",
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}Alternativamente, puede utilizar el script clientSse.ts o probar el servidor utilizando los comandos curl </>.
Inicie eventos enviados por el servidor (SSE) enviando una solicitud GET a la siguiente URL:
curl https://actors-mcp-server.apify.actor/sse?token=<APIFY_TOKEN>El servidor responderá con un
sessionId, que puedes usar para enviar mensajes al servidor:event: endpoint data: /message?sessionId=a1bEnvía un mensaje al servidor realizando una solicitud POST con el
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" } }'El servidor MCP iniciará el actor
lukaskrivka/google-maps-with-contact-detailscon los argumentos proporcionados como parámetros de entrada. Para esta solicitud POST, el servidor responderá con:AcceptedRecibir la respuesta. El servidor invocará al actor especificado como herramienta utilizando los parámetros de consulta proporcionados y transmitirá la respuesta al cliente mediante SSE. La respuesta se devolverá como texto 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+\"...}}]}}
⾕ Servidor MCP en un host local
Puede ejecutar el servidor Apify MCP en su equipo local configurándolo con Claude Desktop o cualquier otro cliente MCP . También puede usar Smithery para instalar el servidor automáticamente.
Prerrequisitos
MacOS o Windows
Se debe instalar la última versión de Claude Desktop (u otro cliente MCP)
Node.js (v18 o superior)
Token de API de Apify (
APIFY_TOKEN)
Asegúrese de tener el node y npx instalados correctamente:
node -v
npx -vDe lo contrario, siga esta guía para instalar Node.js: Descargar e instalar Node.js y npm .
Escritorio de Claude
Para configurar Claude Desktop para que funcione con el servidor MCP, siga estos pasos. Para obtener una guía detallada, consulte la Guía del usuario de Claude Desktop o vea el videotutorial .
Descargar Claude para escritorio
Disponible para Windows y macOS.
Para los usuarios de Linux, pueden crear un paquete Debian utilizando este script de compilación no oficial .
Abra la aplicación Claude Desktop y habilite el Modo de desarrollador desde la barra de menú superior izquierda.
Una vez habilitado, abra Configuración (también desde la barra de menú superior izquierda) y navegue hasta la Opción de desarrollador , donde encontrará el botón Editar configuración .
Abra el archivo de configuración y edite el siguiente archivo:
En macOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonEn Windows:
%APPDATA%/Claude/claude_desktop_config.jsonEn 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" } } } }Alternativamente, puede utilizar el argumento
actorspara seleccionar uno o más actores de 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" } } } }Reiniciar Claude Desktop
Salga completamente de Claude Desktop (asegúrese de que no esté simplemente minimizado o cerrado).
Reinicie Claude Desktop.
Busque el ícono 🔌 para confirmar que el servidor Actors MCP está conectado.
Abra el chat de Claude Desktop y pregunte "¿Qué actores de Apify puedo usar?"

Ejemplos
Puedes pedirle a Claude que realice tareas como:
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.
Código VS
Para la instalación con un solo clic, haga clic en uno de los botones de instalación a continuación:
Instalación manual
Puedes instalar manualmente el servidor Apify MCP en VS Code. Primero, haz clic en uno de los botones de instalación en la parte superior de esta sección para instalarlo con un solo clic.
Como alternativa, agrega el siguiente bloque JSON a tu archivo de configuración de usuario (JSON) en VS Code. Puedes hacerlo presionando Ctrl + Shift + P y escribiendo 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}"
}
}
}
}
}Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo; simplemente omita la clave mcp {} de nivel superior. Esto le permitirá compartir la configuración con otros.
Si desea especificar qué actores cargar, puede agregar el argumento --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}"
}
}
}
}Código VS
Para la instalación con un solo clic, haga clic en uno de los botones de instalación a continuación:
Instalación manual
Puedes instalar manualmente el servidor Apify MCP en VS Code. Primero, haz clic en uno de los botones de instalación en la parte superior de esta sección para instalarlo con un solo clic.
Como alternativa, agrega el siguiente bloque JSON a tu archivo de configuración de usuario (JSON) en VS Code. Puedes hacerlo presionando Ctrl + Shift + P y escribiendo 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}"
}
}
}
}
}Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo; simplemente omita la clave mcp {} de nivel superior. Esto le permitirá compartir la configuración con otros.
Si desea especificar qué actores cargar, puede agregar el argumento --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}"
}
}
}
}Depuración del paquete NPM @apify/actors-mcp-server con @modelcontextprotocol/inspector
Para depurar el servidor, utilice la herramienta MCP Inspector :
export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector npx -y @apify/actors-mcp-serverInstalación mediante herrería
Para instalar Apify Actors MCP Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @apify/actors-mcp-server --client claudeClientes de Stdio
Cree un archivo de entorno .env con el siguiente contenido:
APIFY_TOKEN=your-apify-tokenEn el directorio examples , puede encontrar un cliente de ejemplo para interactuar con el servidor a través de entrada/salida estándar (stdio):
clientStdio.tsEste script de cliente inicia el servidor MCP con dos actores especificados. A continuación, llama a la herramientaapify/rag-web-browsercon una consulta e imprime el resultado. Muestra cómo conectarse al servidor MCP, listar las herramientas disponibles y llamar a una herramienta específica mediante el transporte stdio.node dist/examples/clientStdio.js
👷🏼 Desarrollo
Prerrequisitos
Node.js (v18 o superior)
Python 3.9 o superior
Cree un archivo de entorno .env con el siguiente contenido:
APIFY_TOKEN=your-apify-tokenConstruya el paquete actor-mcp-server:
npm run buildCliente local (SSE)
Para probar el servidor con el transporte SSE, puede usar el script examples/clientSse.ts : Actualmente, el cliente Node.js no permite establecer una conexión con un servidor remoto con encabezados personalizados. Debe cambiar la URL a la de su servidor local en el script.
node dist/examples/clientSse.jsDepuración
Dado que los servidores MCP operan con la entrada/salida estándar (stdio), la depuración puede ser complicada. Para una mejor experiencia de depuración, utilice el Inspector MCP .
Puede iniciar el Inspector MCP a través de npm con este comando:
export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector node ./dist/stdio.jsAl iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.
ⓘ Limitaciones y retroalimentación
El esquema de entrada del actor se procesa para que sea compatible con la mayoría de los clientes MCP, cumpliendo con los estándares de esquema JSON . El procesamiento incluye:
Las descripciones se truncan a 500 caracteres (como se define en
MAX_DESCRIPTION_LENGTH).Los campos de enumeración se truncan a una longitud combinada máxima de 200 caracteres para todos los elementos (como se define en
ACTOR_ENUM_MAX_LENGTH).Los campos obligatorios están marcados explícitamente con un prefijo "REQUERIDO" en sus descripciones para compatibilidad con marcos que pueden no manejar el esquema JSON correctamente.
Las propiedades anidadas se crean para casos especiales, como la configuración de proxy y las fuentes de listas de solicitudes, para garantizar una estructura de entrada correcta.
Los tipos de elementos de la matriz se infieren cuando no están definidos explícitamente en el esquema, utilizando un orden de prioridad: tipo explícito en elementos > tipo de relleno previo > tipo de valor predeterminado > tipo de editor.
Se agregan valores de enumeración y ejemplos a las descripciones de propiedades para garantizar la visibilidad incluso si el cliente no admite totalmente el esquema JSON.
La memoria de cada actor está limitada a 4 GB. Los usuarios gratuitos tienen un límite de 8 GB; se deben asignar 128 MB para ejecutar Actors-MCP-Server .
Si necesita otras funciones o tiene algún comentario, envíe un problema en Apify Console para informarnos.
Hoja de ruta (marzo de 2025)
Agregue el conjunto de datos de Apify y el almacén de valores clave como recursos.
Agregue herramientas como registros de actor y ejecuciones de actor para la depuración.
🐛 Solución de problemas
Asegúrese de tener el
nodeinstalado ejecutandonode -vAsegúrese de tener configurada la variable de entorno
APIFY_TOKENUtilice siempre la última versión del servidor MCP configurando
@apify/actors-mcp-server@latest
📚 Más información
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