actors-mcp-server
OfficialApify Model Context Protocol (MCP)-Server
Implementierung eines MCP-Servers für alle Apify-Akteure . Dieser Server ermöglicht die Interaktion mit einem oder mehreren Apify-Akteuren, die in der MCP-Serverkonfiguration definiert werden können.
Der Server kann auf zwei Arten verwendet werden:
🇦 MCP Server Actor – HTTP-Server, auf den über Server-Sent Events (SSE) zugegriffen werden kann, siehe Anleitung
⾕ MCP Server Stdio – Lokaler Server verfügbar über Standard-Eingabe/Ausgabe (stdio), siehe Anleitung
Sie können auch mit dem MCP-Server über eine chatähnliche Benutzeroberfläche mit 💬 Tester MCP Client interagieren.
🎯 Was macht der Apify MCP-Server?
Der MCP-Server-Akteur ermöglicht es einem KI-Assistenten, jeden Apify-Akteur als Werkzeug zur Ausführung einer bestimmten Aufgabe zu verwenden. Beispielsweise kann er:
Verwenden Sie Facebook Posts Scraper , um Daten aus Facebook-Posts von mehreren Seiten/Profilen zu extrahieren
Verwenden Sie den Google Maps Email Extractor , um die Kontaktdaten von Google Maps zu extrahieren
Verwenden Sie den Google Search Results Scraper, um die Suchergebnisseiten (SERPs) von Google zu scrapen
Verwenden Sie Instagram Scraper , um Instagram-Beiträge, Profile, Orte, Fotos und Kommentare zu scrapen
Verwenden Sie den RAG-Webbrowser, um das Web zu durchsuchen, die Top-N-URLs zu scrapen und deren Inhalt zurückzugeben
MCP-Kunden
Zur Interaktion mit dem Apify MCP-Server können Sie MCP-Clients verwenden wie:
Claude Desktop (nur Stdio-Unterstützung)
Visual Studio Code (Standard- und SSE-Unterstützung)
LibreChat (Standard- und SSE-Unterstützung, jedoch ohne Autorisierungsheader)
Apify Tester MCP-Client (SSE-Unterstützung mit Autorisierungsheadern)
Andere Clients unter https://modelcontextprotocol.io/clients
Weitere Kunden unter https://glama.ai/mcp/clients
Wenn Sie Akteure in den MCP-Server integriert haben, können Sie Folgendes fragen:
„Durchsuchen Sie das Internet und fassen Sie aktuelle Trends zu KI-Agenten zusammen.“
„Finden Sie die 10 besten italienischen Restaurants in San Francisco“
"Finden und analysieren Sie das Instagram-Profil von The Rock"
„Stellen Sie eine Schritt-für-Schritt-Anleitung zur Verwendung des Model Context Protocol mit Quell-URLs bereit.“
„Welche Apify-Akteure kann ich verwenden?“
Das folgende Bild zeigt, wie der Apify MCP-Server mit der Apify-Plattform und KI-Clients interagiert:

Mit dem MCP Tester-Client können Sie Akteure dynamisch laden. Dies wird von anderen MCP-Clients jedoch noch nicht unterstützt. Wir planen außerdem, weitere Funktionen hinzuzufügen. Weitere Informationen finden Sie in der Roadmap .
🔄 Was ist das Model Context Protocol?
Das Model Context Protocol (MCP) ermöglicht KI-Anwendungen (und KI-Agenten) wie Claude Desktop die Verbindung mit externen Tools und Datenquellen. MCP ist ein offenes Protokoll, das sichere, kontrollierte Interaktionen zwischen KI-Anwendungen, KI-Agenten und lokalen oder Remote-Ressourcen ermöglicht.
Weitere Informationen finden Sie auf der Website des Model Context Protocol oder im Blogbeitrag „Was ist MCP und warum ist es wichtig?“ .
🤖 In welcher Beziehung steht der MCP-Server zu KI-Agenten?
Der Apify MCP-Server stellt die Akteure von Apify über das MCP-Protokoll bereit und ermöglicht KI-Agenten oder Frameworks, die das MCP-Protokoll implementieren, den Zugriff auf alle Apify-Akteure als Tools für die Datenextraktion, Websuche und andere Aufgaben.
Um mehr über KI-Agenten zu erfahren, lesen Sie unseren Blogbeitrag: Was sind KI-Agenten? und stöbern Sie in der kuratierten KI-Agenten-Sammlung von Apify. Möchten Sie Ihren eigenen KI-Agenten auf Apify erstellen und monetarisieren? Sehen Sie sich unsere Schritt-für-Schritt-Anleitung zum Erstellen, Veröffentlichen und Monetarisieren von KI-Agenten auf der Apify-Plattform an.
🧱 Komponenten
Werkzeuge
Schauspieler
Jeder Apify-Akteur kann als Werkzeug verwendet werden. Standardmäßig ist der Server mit den unten angegebenen Akteuren vorkonfiguriert. Dies kann jedoch durch die Eingabe von Akteuren überschrieben werden.
'apify/instagram-scraper'
'apify/rag-web-browser'
'lukaskrivka/google-maps-with-contact-details'Der MCP-Server lädt das Actor-Eingabeschema und erstellt die entsprechenden MCP-Tools. Siehe dieses Beispiel eines Eingabeschemas für den RAG-Webbrowser .
Der Toolname muss immer der vollständige Name des Akteurs sein, z. B. apify/rag-web-browser . Die Argumente für ein MCP-Tool stellen die Eingabeparameter des Akteurs dar. Für den Akteur apify/rag-web-browser lauten die Argumente beispielsweise:
{
"query": "restaurants in San Francisco",
"maxResults": 3
}Sie müssen weder die Eingabeparameter noch den aufzurufenden Akteur angeben; alles wird von einem LLM verwaltet. Beim Aufruf eines Tools werden die Argumente automatisch vom LLM an den Akteur übergeben. Eine Liste der verfügbaren Argumente finden Sie in der Dokumentation des jeweiligen Akteurs.
Hilfswerkzeuge
Der Server bietet eine Reihe von Hilfstools zum Auffinden verfügbarer Akteure und zum Abrufen ihrer Details:
get-actor-details: Ruft Dokumentation, Eingabeschema und Details zu einem bestimmten Akteur ab.discover-actors: Sucht anhand von Schlüsselwörtern nach relevanten Schauspielern und gibt deren Details zurück.
Es gibt auch Tools zum Verwalten der verfügbaren Toolliste. Das dynamische Hinzufügen und Entfernen von Tools erfordert jedoch, dass der MCP-Client die Toolliste aktualisieren kann (Handle ToolListChangedNotificationSchema ), was normalerweise nicht unterstützt wird.
Sie können diese Funktionalität mit dem Apify Tester MCP Client Actor testen. Um sie zu aktivieren, setzen Sie den Parameter enableAddingActors .
add-actor-as-tool: Fügt einen Akteur mit Namen zur Liste der verfügbaren Tools hinzu, ohne ihn auszuführen. Für die spätere Ausführung ist die Zustimmung des Benutzers erforderlich.remove-actor-from-tool: Entfernt einen Akteur anhand seines Namens aus der Liste der verfügbaren Tools, wenn er nicht mehr benötigt wird.
Related MCP server: Apify MCP Server
Eingabeaufforderung und Ressourcen
Der Server stellt keine Ressourcen und Eingabeaufforderungen bereit. Wir planen, den Datensatz und den Schlüsselwertspeicher von Apify zukünftig als Ressourcen hinzuzufügen.
⚙️ Verwendung
Der Apify MCP-Server kann auf zwei Arten verwendet werden: als Apify-Akteur, der auf der Apify-Plattform ausgeführt wird, oder als lokaler Server, der auf Ihrem Computer ausgeführt wird.
🇦 MCP-Server-Akteur
Standby-Webserver
Der Actor läuft im Standby-Modus mit einem HTTP-Webserver, der Anfragen empfängt und verarbeitet.
Um den Server mit Standardakteuren zu starten, senden Sie eine HTTP-GET-Anfrage mit Ihrem Apify-API-Token an die folgende URL:
https://actors-mcp-server.apify.actor?token=<APIFY_TOKEN>Es ist auch möglich, den MCP-Server mit einem anderen Satz von Akteuren zu starten. Erstellen Sie dazu eine Aufgabe und geben Sie die Liste der Akteure an, die Sie verwenden möchten.
Führen Sie dann die Aufgabe im Standby-Modus mit den ausgewählten Akteuren aus:
https://USERNAME--actors-mcp-server-task.apify.actor?token=<APIFY_TOKEN>Eine Liste aller verfügbaren Akteure finden Sie im Apify Store .
💬 Interagieren Sie mit dem MCP-Server über SSE
Sobald der Server läuft, können Sie mit Server-Sent Events (SSE) interagieren, um Nachrichten an den Server zu senden und Antworten zu erhalten. Am einfachsten geht das mit dem Tester MCP Client auf Apify.
Claude Desktop unterstützt derzeit keine SSE-Unterstützung, kann aber mit Stdio-Transport verwendet werden. Weitere Informationen finden Sie unter MCP-Server auf einem lokalen Host . Hinweis: Bei der kostenlosen Version von Claude Desktop kann es zeitweise zu Verbindungsproblemen mit dem Server kommen.
In den Clienteinstellungen müssen Sie die Serverkonfiguration angeben:
{
"mcpServers": {
"apify": {
"type": "sse",
"url": "https://actors-mcp-server.apify.actor/sse",
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}Alternativ können Sie das Skript clientSse.ts verwenden oder den Server mit curl </>-Befehlen testen.
Initiieren Sie Server-Sent-Events (SSE), indem Sie eine GET-Anfrage an die folgende URL senden:
curl https://actors-mcp-server.apify.actor/sse?token=<APIFY_TOKEN>Der Server antwortet mit einer
sessionId, die Sie zum Senden von Nachrichten an den Server verwenden können:event: endpoint data: /message?sessionId=a1bSenden Sie eine Nachricht an den Server, indem Sie eine POST-Anfrage mit der
sessionIdstellen: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" } }'Der MCP-Server startet den Akteur
lukaskrivka/google-maps-with-contact-detailsmit den angegebenen Argumenten als Eingabeparameter. Auf diese POST-Anfrage antwortet der Server mit:AcceptedEmpfangen Sie die Antwort. Der Server ruft den angegebenen Akteur als Tool mit den angegebenen Abfrageparametern auf und sendet die Antwort über SSE an den Client zurück. Die Antwort wird als JSON-Text zurückgegeben.
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-Server auf einem lokalen Host
Sie können den Apify MCP-Server auf Ihrem lokalen Rechner ausführen, indem Sie ihn mit Claude Desktop oder einem anderen MCP-Client konfigurieren. Sie können den Server auch mit Smithery automatisch installieren.
Voraussetzungen
MacOS oder Windows
Die neueste Version von Claude Desktop muss installiert sein (oder ein anderer MCP-Client)
Node.js (v18 oder höher)
Apify API-Token (
APIFY_TOKEN)
Stellen Sie sicher, dass Sie den node und npx ordnungsgemäß installiert haben:
node -v
npx -vWenn nicht, befolgen Sie diese Anleitung zur Installation von Node.js: Herunterladen und Installieren von Node.js und npm .
Claude Desktop
So konfigurieren Sie Claude Desktop für den MCP-Server: Eine ausführliche Anleitung finden Sie im Claude Desktop-Benutzerhandbuch oder im Video-Tutorial .
Claude für Desktop herunterladen
Verfügbar für Windows und macOS.
Linux-Benutzer können mit diesem inoffiziellen Build-Skript ein Debian-Paket erstellen.
Öffnen Sie die Claude Desktop-App und aktivieren Sie den Entwicklermodus in der Menüleiste oben links.
Öffnen Sie nach der Aktivierung die Einstellungen (ebenfalls über die Menüleiste oben links) und navigieren Sie zu den Entwickleroptionen , wo Sie die Schaltfläche „Konfiguration bearbeiten“ finden.
Öffnen Sie die Konfigurationsdatei und bearbeiten Sie die folgende Datei:
Unter macOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonUnter Windows:
%APPDATA%/Claude/claude_desktop_config.jsonUnter 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" } } } }Alternativ können Sie das Argument
actorsverwenden, um einen oder mehrere Apify-Akteure auszuwählen:{ "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" } } } }Starten Sie Claude Desktop neu
Beenden Sie Claude Desktop vollständig (stellen Sie sicher, dass es nicht nur minimiert oder geschlossen ist).
Starten Sie Claude Desktop neu.
Suchen Sie nach dem Symbol 🔌, um zu bestätigen, dass der Actors MCP-Server verbunden ist.
Öffnen Sie den Claude Desktop-Chat und fragen Sie: „Welche Apify-Akteure kann ich verwenden?“

Beispiele
Sie können Claude bitten, Aufgaben auszuführen, beispielsweise:
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 Code
Klicken Sie für die Ein-Klick-Installation auf eine der folgenden Installationsschaltflächen:
Manuelle Installation
Sie können den Apify MCP-Server manuell in VS Code installieren. Klicken Sie zunächst auf eine der Installationsschaltflächen oben in diesem Abschnitt, um die Installation mit einem Klick durchzuführen.
Alternativ können Sie den folgenden JSON-Block zu Ihrer Benutzereinstellungsdatei (JSON) in VS Code hinzufügen. Drücken Sie dazu Ctrl + Shift + P und geben Sie Preferences: Open User Settings (JSON) ein.
{
"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}"
}
}
}
}
}Optional können Sie es einer Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich hinzufügen – lassen Sie einfach den mcp {} der obersten Ebene weg. Dadurch können Sie die Konfiguration mit anderen teilen.
Wenn Sie angeben möchten, welche Akteure geladen werden sollen, können Sie das Argument --actors hinzufügen:
{
"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 Code
Klicken Sie für die Ein-Klick-Installation auf eine der folgenden Installationsschaltflächen:
Manuelle Installation
Sie können den Apify MCP-Server manuell in VS Code installieren. Klicken Sie zunächst auf eine der Installationsschaltflächen oben in diesem Abschnitt, um die Installation mit einem Klick durchzuführen.
Alternativ können Sie den folgenden JSON-Block zu Ihrer Benutzereinstellungsdatei (JSON) in VS Code hinzufügen. Drücken Sie dazu Ctrl + Shift + P und geben Sie Preferences: Open User Settings (JSON) ein.
{
"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}"
}
}
}
}
}Optional können Sie es einer Datei namens .vscode/mcp.json in Ihrem Arbeitsbereich hinzufügen – lassen Sie einfach den mcp {} der obersten Ebene weg. Dadurch können Sie die Konfiguration mit anderen teilen.
Wenn Sie angeben möchten, welche Akteure geladen werden sollen, können Sie das Argument --actors hinzufügen:
{
"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}"
}
}
}
}Debuggen des NPM-Pakets @apify/actors-mcp-server mit @modelcontextprotocol/inspector
Verwenden Sie zum Debuggen des Servers das MCP Inspector- Tool:
export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector npx -y @apify/actors-mcp-serverInstallation über Smithery
So installieren Sie den Apify Actors MCP Server für Claude Desktop automatisch über Smithery :
npx -y @smithery/cli install @apify/actors-mcp-server --client claudeStdio-Clients
Erstellen Sie eine Umgebungsdatei .env mit folgendem Inhalt:
APIFY_TOKEN=your-apify-tokenIm Verzeichnis examples finden Sie einen Beispielclient zur Interaktion mit dem Server über die Standardeingabe/-ausgabe (stdio):
clientStdio.tsDieses Client-Skript startet den MCP-Server mit zwei angegebenen Akteuren. Anschließend ruft es das Toolapify/rag-web-browsermit einer Abfrage auf und gibt das Ergebnis aus. Es zeigt, wie man sich mit dem MCP-Server verbindet, verfügbare Tools auflistet und ein bestimmtes Tool per stdio-Transport aufruft.node dist/examples/clientStdio.js
👷🏼 Entwicklung
Voraussetzungen
Node.js (v18 oder höher)
Python 3.9 oder höher
Erstellen Sie eine Umgebungsdatei .env mit folgendem Inhalt:
APIFY_TOKEN=your-apify-tokenErstellen Sie das Actor-MCP-Server-Paket:
npm run buildLokaler Client (SSE)
Um den Server mit dem SSE-Transport zu testen, können Sie das Skript examples/clientSse.ts verwenden: Derzeit unterstützt der Node.js-Client keine Verbindung zu einem Remote-Server mit benutzerdefinierten Headern. Sie müssen die URL im Skript in die URL Ihres lokalen Servers ändern.
node dist/examples/clientSse.jsDebuggen
Da MCP-Server über Standard-Ein-/Ausgabe (stdio) arbeiten, kann das Debuggen eine Herausforderung darstellen. Für optimale Ergebnisse beim Debuggen verwenden Sie den MCP Inspector .
Sie können den MCP Inspector über npm mit diesem Befehl starten:
export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector node ./dist/stdio.jsBeim Start zeigt der Inspector eine URL an, auf die Sie in Ihrem Browser zugreifen können, um mit dem Debuggen zu beginnen.
ⓘ Einschränkungen und Feedback
Das Actor-Eingabeschema wird so verarbeitet, dass es mit den meisten MCP-Clients kompatibel ist und gleichzeitig den JSON-Schema- Standards entspricht. Die Verarbeitung umfasst:
Beschreibungen werden auf 500 Zeichen gekürzt (wie in
MAX_DESCRIPTION_LENGTHdefiniert).Enumerationsfelder werden für alle Elemente auf eine maximale Gesamtlänge von 200 Zeichen gekürzt (wie in
ACTOR_ENUM_MAX_LENGTHdefiniert).Erforderliche Felder sind in ihren Beschreibungen ausdrücklich mit dem Präfix „ERFORDERLICH“ gekennzeichnet, um die Kompatibilität mit Frameworks sicherzustellen, die das JSON-Schema möglicherweise nicht richtig verarbeiten.
Für Sonderfälle wie die Proxy-Konfiguration und Anforderungslistenquellen werden verschachtelte Eigenschaften erstellt, um eine korrekte Eingabestruktur sicherzustellen.
Array-Elementtypen werden abgeleitet, wenn sie nicht explizit im Schema definiert sind. Dabei wird eine Prioritätsreihenfolge verwendet: expliziter Typ in Elementen > Vorfülltyp > Standardwerttyp > Editortyp.
Den Eigenschaftsbeschreibungen werden Enumerationswerte und Beispiele hinzugefügt, um die Sichtbarkeit sicherzustellen, auch wenn der Client das JSON-Schema nicht vollständig unterstützt.
Der Arbeitsspeicher für jeden Akteur ist auf 4 GB begrenzt. Für kostenlose Benutzer gilt ein Limit von 8 GB. Für die Ausführung Actors-MCP-Server müssen 128 MB zugewiesen werden.
Wenn Sie andere Funktionen benötigen oder Feedback haben, senden Sie ein Problem in der Apify-Konsole, um uns dies mitzuteilen.
🚀 Roadmap (März 2025)
Fügen Sie den Datensatz und den Schlüssel-Wert-Speicher von Apify als Ressourcen hinzu.
Fügen Sie Tools wie Actor-Protokolle und Actor-Läufe zum Debuggen hinzu.
🐛 Fehlerbehebung
Stellen Sie sicher, dass der
nodeinstalliert ist, indem Sienode -vausführen.Stellen Sie sicher, dass Sie die Umgebungsvariable
APIFY_TOKENfestgelegt habenVerwenden Sie immer die neueste Version des MCP-Servers, indem Sie
@apify/actors-mcp-server@latestfestlegen
📚 Mehr erfahren
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