actors-mcp-server
OfficialApify モデルコンテキストプロトコル (MCP) サーバー
すべてのApifyアクター用のMCPサーバーの実装。このサーバーは、MCPサーバー構成で定義できる1つ以上のApifyアクターとのやり取りを可能にします。
サーバーは次の 2 つの方法で使用できます。
🇦 MCP サーバーアクター– Server-Sent Events (SSE) 経由でアクセス可能な HTTP サーバー。ガイドを参照
⾕ MCP Server Stdio – 標準入出力(stdio)経由で利用可能なローカルサーバー。ガイドを参照
💬 Tester MCP Clientを使用すると、チャットのような UI を使用して MCP サーバーと対話することもできます。
🎯 Apify MCP サーバーは何をしますか?
MCP Server Actorを使用すると、AIアシスタントは任意のApify Actorを特定のタスクを実行するツールとして使用できます。例えば、次のようなことが可能です。
Facebook投稿スクレーパーを使用して、複数のページ/プロフィールのFacebook投稿からデータを抽出します。
Google Maps Email Extractor を使用して Google マップの連絡先の詳細を抽出します
Google 検索結果スクレーパーを使用して、Google 検索エンジン結果ページ (SERP) をスクレイピングします。
Instagram Scraperを使用して、Instagramの投稿、プロフィール、場所、写真、コメントをスクレイピングします
RAG Webブラウザを使用してWebを検索し、上位N個のURLをスクレイピングしてそのコンテンツを返します
MCPクライアント
Apify MCP サーバーと対話するには、次のような MCP クライアントを使用できます。
Claude デスクトップ(Stdio のみサポート)
Visual Studio Code (Stdio および SSE サポート)
LibreChat (Stdio および SSE をサポート、ただし Authorization ヘッダーなし)
Apify Tester MCP クライアント(認証ヘッダーによる SSE サポート)
その他のクライアントについては、https://modelcontextprotocol.io/clientsをご覧ください。
その他のクライアントについては、https://glama.ai/mcp/clientsをご覧ください。
アクターを MCP サーバーに統合すると、次のことを尋ねることができます。
「Webで検索してAIエージェントの最新動向をまとめる」
「サンフランシスコのベストイタリアンレストラン トップ10 を見つける」
「ザ・ロックのインスタグラムプロフィールを見つけて分析する」
「ソース URL でモデル コンテキスト プロトコルを使用するためのステップバイステップ ガイドを提供する」
「どの Apify アクターを使用できますか?」
次の図は、Apify MCP サーバーが Apify プラットフォームおよび AI クライアントと対話する方法を示しています。

MCP Testerクライアントではアクターを動的にロードできますが、他のMCPクライアントではまだサポートされていません。今後、さらに多くの機能を追加する予定です。詳細はロードマップをご覧ください。
🔄 モデルコンテキストプロトコルとは何ですか?
モデルコンテキストプロトコル(MCP)は、Claude DesktopなどのAIアプリケーション(およびAIエージェント)が外部ツールやデータソースに接続できるようにします。MCPは、AIアプリケーション、AIエージェント、ローカルまたはリモートリソース間の安全で制御されたインタラクションを可能にするオープンプロトコルです。
詳細については、モデル コンテキスト プロトコルのWeb サイトまたはブログ記事「MCP とは何か、なぜ重要なのか?」を参照してください。
🤖 MCP サーバーは AI エージェントとどのように関連していますか?
Apify MCP サーバーは、MCP プロトコルを通じて Apify のアクターを公開し、MCP プロトコルを実装する AI エージェントまたはフレームワークが、データ抽出、Web 検索、その他のタスクのツールとしてすべての Apify アクターにアクセスできるようにします。
AIエージェントの詳細については、ブログ記事「 AIエージェントとは?」をご覧いただき、Apifyが厳選したAIエージェントコレクションをご覧ください。Apifyで独自のAIエージェントを構築し、収益化することに興味がありますか?ApifyプラットフォームでAIエージェントを作成、公開、収益化するためのステップバイステップガイドをご覧ください。
🧱 コンポーネント
ツール
俳優
Apifyアクターはツールとして使用できます。デフォルトでは、サーバーは以下のアクターで事前設定されていますが、アクター入力を提供することでこれをオーバーライドできます。
'apify/instagram-scraper'
'apify/rag-web-browser'
'lukaskrivka/google-maps-with-contact-details'MCPサーバーはアクター入力スキーマを読み込み、アクターに対応するMCPツールを作成します。RAG Webブラウザの入力スキーマの例については、こちらをご覧ください。
ツール名は常に完全なアクター名(例: apify/rag-web-browserでなければなりません。MCPツールの引数は、アクターの入力パラメータを表します。例えば、 apify/rag-web-browserアクターの場合、引数は以下のとおりです。
{
"query": "restaurants in San Francisco",
"maxResults": 3
}入力パラメータや呼び出すアクターを指定する必要はありません。すべてはLLMによって管理されます。ツールが呼び出されると、LLMによって引数が自動的にアクターに渡されます。使用可能な引数のリストについては、各アクターのドキュメントを参照してください。
ヘルパーツール
サーバーは、利用可能なアクターを検出し、その詳細を取得するための一連のヘルパー ツールを提供します。
get-actor-details: 特定の Actor に関するドキュメント、入力スキーマ、および詳細を取得します。discover-actors: キーワードを使用して関連するアクターを検索し、その詳細を返します。
利用可能なツールリストを管理するツールもあります。ただし、ツールを動的に追加または削除するには、MCPクライアントがツールリストを更新する機能( ToolListChangedNotificationSchema処理)を備えている必要がありますが、これは通常サポートされていません。
この機能は、Apify Tester MCPクライアントアクターを使用してお試しいただけます。有効にするには、 enableAddingActorsパラメータを設定してください。
add-actor-as-tool: 実行せずに、名前でアクターを使用可能なツール リストに追加します。後で実行する場合はユーザーの同意が必要です。remove-actor-from-tool: 不要になったアクターを、使用可能なツールのリストから名前で削除します。
Related MCP server: Apify MCP Server
プロンプトとリソース
サーバーはリソースとプロンプトを提供していません。将来的には、Apify のデータセットとキーバリューストアをリソースとして追加する予定です。
⚙️ 使用方法
Apify MCP サーバーは、Apify プラットフォーム上で実行されるApify アクターとして使用するか、マシン上で実行されるローカル サーバーとして使用するかの 2 つの方法で使用できます。
🇦 MCP サーバー アクター
スタンバイウェブサーバー
アクターは、リクエストを受信して処理する HTTP Web サーバーを使用してスタンバイ モードで実行されます。
デフォルトのアクターでサーバーを起動するには、 Apify API トークンを含む HTTP GET リクエストを次の URL に送信します。
https://actors-mcp-server.apify.actor?token=<APIFY_TOKEN>MCPサーバーを別のアクターセットで起動することも可能です。これを行うには、タスクを作成し、使用するアクターのリストを指定します。
次に、選択したアクターでタスクをスタンバイ モードで実行します。
https://USERNAME--actors-mcp-server-task.apify.actor?token=<APIFY_TOKEN>利用可能なすべてのアクターのリストは、 Apify ストアで確認できます。
💬 SSE経由でMCPサーバーとやりとりする
サーバーが起動したら、Server-Sent Events(SSE)を利用してサーバーにメッセージを送信し、レスポンスを受信できます。最も簡単な方法は、ApifyのTester MCPクライアントを使用することです。
Claude Desktopは現在SSEをサポートしていませんが、Stdioトランスポートで使用できます。詳細については、ローカルホストのMCPサーバーを参照してください。注:Claude Desktopの無料版では、サーバーとの接続が断続的に問題が発生する場合があります。
クライアント設定では、サーバー構成を指定する必要があります。
{
"mcpServers": {
"apify": {
"type": "sse",
"url": "https://actors-mcp-server.apify.actor/sse",
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}あるいは、 clientSse.tsスクリプトを使用したり、 curl </> コマンドを使用してサーバーをテストしたりすることもできます。
次の URL に GET リクエストを送信して、Server-Sent-Events (SSE) を開始します。
curl https://actors-mcp-server.apify.actor/sse?token=<APIFY_TOKEN>サーバーは
sessionIdで応答し、これを使用してサーバーにメッセージを送信できます。event: endpoint data: /message?sessionId=a1bsessionIdを使用して POST リクエストを作成し、サーバーにメッセージを送信します。curl -X POST "https://actors-mcp-server.apify.actor/message?token=<APIFY_TOKEN>&session_id=a1b" -H "Content-Type: application/json" -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "arguments": { "searchStringsArray": ["restaurants in San Francisco"], "maxCrawledPlacesPerSearch": 3 }, "name": "lukaskrivka/google-maps-with-contact-details" } }'MCPサーバーは、指定された引数を入力パラメータとして、アクター
lukaskrivka/google-maps-with-contact-detailsを起動します。このPOSTリクエストに対して、サーバーは次のように応答します。Acceptedレスポンスを受信します。サーバーは指定されたクエリパラメータを使用して、指定されたアクターをツールとして呼び出し、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サーバーは、Claude Desktopまたはその他のMCPクライアントで設定することで、ローカルマシン上で実行できます。また、 Smitheryを使用してサーバーを自動的にインストールすることもできます。
前提条件
MacOSまたはWindows
Claude Desktopの最新バージョン(または別のMCPクライアント)がインストールされている必要があります
Node.js (v18以上)
Apify API トークン(
APIFY_TOKEN)
nodeとnpxが適切にインストールされていることを確認してください。
node -v
npx -vそうでない場合は、次のガイドに従って Node.js をインストールします: Node.js と npm のダウンロードとインストール。
クロードデスクトップ
Claude DesktopをMCPサーバーと連携させるには、以下の手順に従ってください。詳細な手順については、 Claude Desktopユーザーズガイドを参照するか、ビデオチュートリアルをご覧ください。
デスクトップ版Claudeをダウンロード
Windows および macOS で利用できます。
Linux ユーザーの場合は、この非公式ビルド スクリプトを使用して Debian パッケージをビルドできます。
Claude デスクトップ アプリを開き、左上のメニュー バーから開発者モードを有効にします。
有効にしたら、 [設定] (左上のメニュー バーから) を開き、[**開発者オプション]**に移動して、 **[構成の編集]**ボタンを見つけます。
構成ファイルを開き、次のファイルを編集します。
macOSの場合:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows の場合:
%APPDATA%/Claude/claude_desktop_config.jsonLinuxの場合:
~/.config/Claude/claude_desktop_config.json
{ "mcpServers": { "actors-mcp-server": { "command": "npx", "args": ["-y", "@apify/actors-mcp-server"], "env": { "APIFY_TOKEN": "your-apify-token" } } } }あるいは、
actors引数を使用して 1 つ以上の 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デスクトップを再起動します
Claude Desktop を完全に終了します (最小化または閉じられているだけではないことを確認します)。
Claude Desktop を再起動します。
Actors MCP サーバーが接続されていることを確認するには、🔌 アイコンを探します。
Claude Desktop チャットを開き、「どの Apify Actors を使用できますか?」と質問します。

例
Claude に次のようなタスクの実行を依頼できます。
Find and analyze recent research papers about LLMs. Find the top 10 best Italian restaurants in San Francisco. Find and analyze the Instagram profile of The Rock.
VSコード
ワンクリックでインストールするには、以下のいずれかのインストールボタンをクリックします。
手動インストール
Apify MCP ServerはVS Codeで手動でインストールできます。まず、このセクションの上部にあるインストールボタンのいずれかをクリックして、ワンクリックでインストールしてください。
または、VS Codeのユーザー設定(JSON)ファイルに次のJSONブロックを追加することもできます。Ctrl 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で手動でインストールできます。まず、このセクションの上部にあるインストールボタンのいずれかをクリックして、ワンクリックでインストールしてください。
または、VS Codeのユーザー設定(JSON)ファイルに次のJSONブロックを追加することもできます。Ctrl 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}"
}
}
}
}@modelcontextprotocol/inspector を使用して NPM パッケージ @apify/actors-mcp-server をデバッグする
サーバーをデバッグするには、 MCP Inspectorツールを使用します。
export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector npx -y @apify/actors-mcp-serverSmithery経由でインストール
Smithery経由で Claude Desktop 用の Apify Actors MCP Server を自動的にインストールするには:
npx -y @smithery/cli install @apify/actors-mcp-server --client claudeStdioクライアント
次の内容を含む環境ファイル.envを作成します。
APIFY_TOKEN=your-apify-tokenexamplesディレクトリには、標準入出力 (stdio) を介してサーバーと対話するサンプル クライアントがあります。
clientStdio.tsこのクライアントスクリプトは、指定された2つのアクターを使用してMCPサーバーを起動します。その後、apify/rag-web-browserツールをクエリとともに呼び出し、結果を出力します。MCPサーバーへの接続方法、利用可能なツールの一覧表示、stdioトランスポートを使用した特定のツールの呼び出し方法を示します。node dist/examples/clientStdio.js
👷🏼 開発
前提条件
Node.js (v18以上)
Python 3.9以上
次の内容を含む環境ファイル.envを作成します。
APIFY_TOKEN=your-apify-tokenactor-mcp-server パッケージをビルドします。
npm run buildローカルクライアント(SSE)
SSEトランスポートを使用したサーバーをテストするには、スクリプトexamples/clientSse.tsを使用できます。現在、Node.jsクライアントはカスタムヘッダーを使用したリモートサーバーへの接続をサポートしていません。スクリプト内のURLをローカルサーバーのURLに変更する必要があります。
node dist/examples/clientSse.jsデバッグ
MCPサーバーは標準入出力(stdio)を介して動作するため、デバッグが困難になる場合があります。最適なデバッグ環境を得るには、 MCP Inspectorを使用してください。
次のコマンドを使用して、 npm経由で MCP Inspector を起動できます。
export APIFY_TOKEN=your-apify-token
npx @modelcontextprotocol/inspector node ./dist/stdio.js起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。
ⓘ 制限事項とフィードバック
アクター入力スキーマは、 JSONスキーマ標準に準拠しながら、ほとんどのMCPクライアントと互換性を持つように処理されます。処理には以下が含まれます。
説明は500 文字に切り捨てられます (
MAX_DESCRIPTION_LENGTHで定義されています)。列挙フィールドは、すべての要素の最大合計長が 200 文字になるように切り捨てられます (
ACTOR_ENUM_MAX_LENGTHで定義)。必須フィールドには、JSON スキーマを適切に処理できない可能性のあるフレームワークとの互換性を確保するために、説明に「REQUIRED」というプレフィックスが明示的に付けられます。
ネストされたプロパティは、プロキシ構成や要求リスト ソースなどの特殊なケース用に構築され、正しい入力構造を保証します。
**配列項目のタイプは、**スキーマで明示的に定義されていない場合、優先順位を使用して推論されます: 項目内の明示的なタイプ > 事前入力タイプ > デフォルト値タイプ > エディタータイプ。
クライアントが JSON スキーマを完全にサポートしていない場合でも可視性を確保するために**、列挙値と例が**プロパティの説明に追加されます。
各アクターのメモリは4GBに制限されています。無料ユーザーの場合は8GBの制限があり、 Actors-MCP-Serverを実行するには128MBのメモリを割り当てる必要があります。
他の機能が必要な場合やフィードバックがある場合は、Apify コンソールで問題を送信してお知らせください。
🚀 ロードマップ(2025年3月)
Apify のデータセットとキー値ストアをリソースとして追加します。
デバッグ用に、Actor ログや Actor 実行などのツールを追加します。
🐛 トラブルシューティング
node -vを実行してnodeがインストールされていることを確認してください。APIFY_TOKEN環境変数が設定されていることを確認してください@apify/actors-mcp-server@latestを設定して、常に最新バージョンの MCP サーバーを使用します。
📚詳細はこちら
Available Tools
13 toolsabort-actor-runAbort Actor runADestructiveIdempotentInspect
Abort an Actor run that is currently starting or running. For runs with status SUCCEEDED, FAILED, ABORTING, ABORTED, or TIMED-OUT, this call has no effect. The results will include the updated run details after the abort request.
USAGE:
Use when you need to stop a run that is taking too long or misconfigured.
USAGE EXAMPLES:
user_input: Abort run y2h7sK3Wc
user_input: Gracefully abort run y2h7sK3Wc
Inputs: runId (required), gracefully. Returns: tip, runId, stats, status, +10 more
call-actorCall ActorADestructiveInspect
Call any Actor from the Apify Store.
WORKFLOW:
Use fetch-actor-details to get the Actor's input schema
Call this tool with the actor name and proper input based on the schema
If the actor name is not in "username/name" format, use search-actors to resolve the correct Actor first.
An MCP server Actor with no input schema is not run here; call-actor-mcp-tool calls its MCP tools.
For Server Actors (Actors with an HTTP API):
This tool starts a batch run and stores the results in a dataset; use it when you need batch results
For one or a few results, send-server-actor-request returns them in the HTTP response, without a batch run
fetch-actor-details with output={ serverInterface: true } lists its HTTP operations
IMPORTANT:
Waits up to waitSecs (default 30s) for completion; returns run status and storage IDs, and with waitSecs > 0 also reports dataset field metadata
Use get-dataset-items with the datasetId to fetch results; non-terminal runs include a nextStep with polling instructions
There are two ways to use an Actor:
Its dedicated tool, when the session has one: a Server Actor's tool sends one HTTP request to its API, an MCP server Actor's tools call its MCP server, and any other Actor's tool starts a run.
The generic call-actor tool: starts a run of any Actor and stores the results in a dataset.
USAGE:
Prefer the dedicated tool when the session has one for the Actor
call-actor runs an Actor that has no dedicated tool, and batch work whose results belong in a dataset.
Use
waitSecs(0–45) to control how long to wait. Default 30s returns results for fast actors. UsewaitSecs: 0to start and return immediately for long-running actors.
EXAMPLES:
user_input: Get instagram posts using apify/instagram-scraper
Inputs: actor (required), input (required), waitSecs, callOptions. Returns: tip, runId, stats, status, +10 more
call-actor-mcp-toolCall Actor MCP toolADestructiveInspect
Call one tool on an Actor's MCP server and return its result. fetch-actor-mcp-tool-list lists the Actor's MCP tools and their input schemas. It connects with your Apify API token. Connecting can start a Server Actor run in your account, kept until its idle timeout; a multi-tenant Server Actor charges per event. What the tool itself does depends on the Actor.
Example call: {"actor": "username/name", "tool": "search", "arguments": {"query": "apify"}}
USAGE:
Use when the user asks to call a tool on an Actor's MCP server.
USAGE EXAMPLES:
user_input: Use the search tool of username/name to look up apify
Inputs: tool (required), actor (required), arguments.
fetch-actor-detailsFetch Actor detailsARead-onlyIdempotentInspect
Get detailed information about an Actor by its ID or full name (format: "username/name", e.g., "apify/rag-web-browser").
Requires the exact ID or full name — do not construct a plausible-looking name and call this tool with it. If you only have a description, a partial name, or a name you have not seen in this conversation, find it with search-actors first.
Use 'output' to control returned information:
Default: all fields except outputSchema and serverInterface. Server Actors always get a one-line server interface summary unless serverInterface is true or a selector.
Selective: set only the fields you need to true, e.g. output: { inputSchema: true }
Common patterns: inputSchema only, description + readme, serverInterface: true (every operation in full when they fit, an index of them otherwise) or "GET /search" (one operation in full) for Server Actors
The 'readme' field returns the summary when available, full README otherwise. Use when querying Actor details, documentation, or input requirements. It does not connect to an MCP server Actor; fetch-actor-mcp-tool-list lists its MCP tools.
EXAMPLES:
What does apify/web-fetch do?
What is the input schema for apify/web-scraper?
What HTTP operations does this Server Actor expose?
Inputs: actor (required), output. Returns: readme, nextStep, actorInfo, inputSchema, +2 more
fetch-actor-mcp-tool-listFetch Actor MCP tool listAInspect
List an Actor's MCP tools with each tool's name, description, input schema, annotations, and metadata, as the server reports them. call-actor-mcp-tool calls one of them by name. Each call asks the server again; nothing is cached. It connects with your Apify API token. Connecting can start a Server Actor run in your account, kept until its idle timeout; a multi-tenant Server Actor charges per event.
USAGE:
Use when the user asks which MCP tools an Actor provides, or before calling one of them.
USAGE EXAMPLES:
user_input: What tools does username/name provide?
Inputs: actor (required). Returns: tools
fetch-apify-docsFetch Apify docsARead-onlyIdempotentInspect
Fetch the full content of an Apify or Crawlee documentation page by its URL. Use this after finding a relevant page with the search-apify-docs tool.
USAGE:
Use when you need the complete content of a specific docs page for detailed answers.
USAGE EXAMPLES:
user_input: Fetch https://docs.apify.com/platform/actors/running#builds
user_input: Fetch https://docs.apify.com/academy
user_input: Fetch https://crawlee.dev/docs/guides/basic-concepts
Inputs: url (required). Returns: url, content
get-actor-runGet Actor runARead-onlyIdempotentInspect
Get detailed information about a specific Actor run.
Returns run result: status, storages (datasets/keyValueStores alias map), stats, summary, nextStep.
summary describes the past (e.g. "SUCCEEDED in 22s. 47 items; 3 fields available.").
nextStep prescribes one primary follow-up action with identifiers interpolated (e.g. "Use get-dataset-items with datasetId=...").
waitSecs (0–45, default 30) waits up to that many seconds for terminal status before returning.
USAGE:
Use to check the status of a run started by any Actor-running tool.
Pass waitSecs > 0 to block until terminal (or until the cap elapses).
USAGE EXAMPLES:
user_input: Show details of run y2h7sK3Wc
user_input: Wait for run y2h7sK3Wc to finish
Inputs: runId (required), waitSecs. Returns: tip, runId, stats, status, +10 more
get-dataset-itemsGet dataset itemsARead-onlyIdempotentInspect
Get items (rows) from a dataset — the output/results produced by an Actor run. Returns the rows themselves, not dataset metadata, counts, or a schema. When the user provides a datasetId and asks to retrieve results, output, data, or rows, call this tool directly. Default limit is 20. Use clean=true to skip empty items and hidden fields.
USAGE:
Use when you need to read data from a dataset (all items or only selected fields).
USAGE EXAMPLES:
user_input: Retrieve results from dataset abc123
user_input: Get only metadata.url and title from dataset username~my-dataset
Inputs: datasetId (required), desc, omit, clean, +4 more. Returns: items, limit, offset, summary, +5 more
get-key-value-store-recordGet key-value store recordARead-onlyIdempotentInspect
Get the value stored under a specific key in a key-value store — a single record, not a listing of all keys. Requires the exact key name. The response preserves the original Content-Encoding; most clients handle decompression automatically. A record over 262144 bytes is returned as a link to download it, not as its value.
USAGE:
Use when you need to retrieve a specific record (JSON, text, or binary) from a store.
USAGE EXAMPLES:
user_input: Get record INPUT from store abc123
user_input: Get record data.json from store username~my-store
Inputs: recordKey (required), keyValueStoreId (required). Returns: key, value, summary, contentType, +1 more
report-problemReport a problemAInspect
Report a problem with Apify's MCP tools or Actors to the Apify team.
Reports can describe missing tools or Actors, errors, timeouts, confusing results, steps that took several attempts, or tasks that the available tools could not complete. Reports help fix the problem for other users.
Put what you were doing and what went wrong in "message". Do NOT include personal data, credentials, secrets, or verbatim private conversation content — describe the issue in your own words.
Inputs: message (required), actorId, actorRunId, relatedTools. Returns: reported
search-actorsSearch ActorsARead-onlyIdempotentInspect
Search the Apify Store to FIND and DISCOVER what scraping tools/Actors exist for specific platforms or use cases. This tool provides INFORMATION about available Actors - it does NOT retrieve actual data or run any scraping tasks.
Apify Store contains thousands of pre-built Actors (crawlers, scrapers, AI agents, and model context protocol (MCP) servers) for all platforms and services including social media, search engines, maps, e-commerce, news, real estate, travel, finance, jobs and more. Apify Store lists Actors published by Apify and by independent developers.
Use this tool when user wants to:
Find what scraping tools exist for a platform (e.g., "What tools can scrape Instagram?")
Discover available Actors for a use case (e.g., "Find an Actor for Amazon products")
Browse existing solutions (e.g., "Show me scrapers for news sites")
Learn about MCP servers or AI agents available in the Store
This tool discovers Actors; it does not retrieve their output. IMPORTANT: When the user wants detailed data from a specific platform or is looking for scraping tools, prefer searching the Store first — a relevant Actor often already exists. When the user names a specific Actor, look up that Actor directly instead of searching.
Usage:
Use 1-3 simple terms from the platform and/or data type the user named (e.g. "Instagram posts", "Twitter", "Amazon products"). With neither named, empty keywords return the Store's default ordering. A platform-only query is an option if more specific results do not fit.
Important limitations: This tool does not return full Actor documentation or detailed usage instructions - only summary information.
Each result lists the Actor's input fields with their types (e.g. url: string, maxResults?: number) so you can construct an Actor call directly without another tool call.
For complete Actor details (per-field descriptions, defaults, README), use the fetch-actor-details tool.
The search is limited to publicly available Actors and excludes rental and restricted Actors.
Returns list of Actor cards with the following info:
Title: Markdown header linked to the Store page, followed by the full Actor name in code format
URL: Direct Store link
Description: Actor description or fallback
Pricing: Details with pricing link
Stats: Total and monthly users
Rating: Out of 5 (if available)
Developed by: Username linked to profile, marked (Apify) or (community)
Categories: Formatted or "Uncategorized"
Last modified: Date (if available)
Input fields: Inline list of input field names and types (e.g.
url: string, maxResults?: number);?marks optional fields,... (+N more)marks a truncated list
Inputs: limit, offset, useCase, keywords. Returns: count, query, actors, userTier, +1 more
search-apify-docsSearch Apify docsARead-onlyIdempotentInspect
Search Apify and Crawlee documentation using full-text search. Do not also search the Apify Store unless the user asks to find Actors.
You must explicitly select which documentation source to search using the docSource parameter:
• docSource="apify" - Apify: Apify Platform documentation including: Platform features, SDKs (JS, Python), CLI, REST API, Academy (web scraping fundamentals), Actor development and deployment
• docSource="crawlee-js" - Crawlee (JavaScript): Crawlee is a web scraping library for JavaScript. It handles blocking, crawling, proxies, and browsers for you.
• docSource="crawlee-py" - Crawlee (Python): Crawlee is a web scraping library for Python. It handles blocking, crawling, proxies, and browsers for you.
The results will include the URL of the documentation page (which may include an anchor), and a limited piece of content that matches the search query.
Fetch the full content of the document using the fetch-apify-docs tool by providing the URL.
When results contain both platform documentation (docs.apify.com/platform) and Academy content (docs.apify.com/academy) on the same topic, prefer the platform documentation.
Inputs: query (required), limit, offset, docSource. Returns: results, instructions
send-server-actor-requestSend Server Actor requestADestructiveInspect
Send one HTTP request to an Actor Server: the HTTP API of a Server Actor, documented in its API schema (OpenAPI) and README. fetch-actor-details with output.serverInterface returns the documented operations with their parameters. Give the method, the path, and optionally query parameters and a JSON body; the Actor Server's host and your Apify API token are added for you. Only an Actor with an Actor Server and an API schema takes requests here; the Actor accepts or rejects the method and path. A request to a single-tenant Actor Server can start a run of the Actor in your account, kept until its idle timeout; a multi-tenant Actor Server charges per event. The request is sent once, with no retries and without following redirects. A JSON, text, or XML response body is returned as text, cut at 262144 bytes; other content types are not returned.
Example call: {"actor": "apify/rag-web-browser", "method": "GET", "path": "/search", "query": {"query": "AI news", "maxResults": 3}}
USAGE:
Use when the Actor that fits the user's request has an Actor Server, and its API schema or README names the endpoint for the task.
Fits requests for one or a few results returned in the HTTP response. Larger batches depend on the endpoint and the response size and time limits.
USAGE EXAMPLES:
user_input: Search the web for the latest AI news and read the top pages with apify/rag-web-browser
user_input: Read https://docs.apify.com as Markdown with apify/rag-web-browser
Inputs: path (required), actor (required), method (required), body, +1 more. Returns: body, path, bytes, method, +13 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Most tools target clearly distinct actions (search, fetch details, run, abort, read dataset, docs search/fetch). The only murky cluster is call-actor vs call-actor-mcp-tool vs send-server-actor-request, which all 'invoke' something, but the descriptions clearly differentiate generic runs, MCP tool calls, and HTTP endpoint requests.
All 13 tools use consistent kebab-case verb-first naming: fetch-*, search-*, get-*, call-*, abort-*, send-*, report-*. No mixing of conventions or casing styles.
13 tools sits squarely in the well-scoped range for an Actor hub that must cover discovery, execution, storage retrieval, docs, and reporting. Each tool maps to a distinct step in the workflow.
The surface covers the full Actor lifecycle (discover, inspect, run, poll, abort) plus dataset and key-value access, docs, MCP tool invocation, server HTTP requests, and problem reporting. Minor gaps remain: no listing of a user's own runs/actors or dataset/key-value-store enumeration, though agents can work around these with known IDs.
Maintenance
Related MCP Connectors
No-code web scraping & data-extraction Apify actors: scrape and enrich web data at scale.
No-code web scraping & data-extraction Apify actors: scrape and enrich web data at scale.
Pay-per-use Apify tools for AI classification, SEO audits, leads, transcripts and web data.
64 public Apify Actors for public-record, jobs, lead, SEO and social data, as MCP tools.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceExposes over 19,000 Apify Actors as MCP tools for web scraping, data extraction, and OSINT automation. It enables AI agents to dynamically discover and execute scrapers to collect structured data and crawl web content.MIT
- AlicenseNot gradedqualityDmaintenanceEnables web scraping, browser automation, and dataset management through Apify's actor platform.MIT
- AlicenseAqualityBmaintenance35 public-data MCP tools with optional focused profiles for business leads, market intelligence, government records, and research/health. Includes Maps, jobs, SEC filings, grants, sanctions and more. Runs use your own Apify account and are billed there. Structured results and deterministic errors.43MIT

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