- Category: model context protocol
- Auth: DCR_OAUTH
- Composio-managed OAuth available? No
- Tools: 12
- Triggers: 0
- Slug:
APIFY_MCP - Version: 20261018_00
Tools
Abort-actor-run
Abort-actor-run
Slug:
APIFY_MCP_ABORT_ACTOR_RUNAbort 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.
- user_input: Abort run y2h7sK3Wc
- user_input: Gracefully abort run y2h7sK3Wc
Input Parameters
Output
Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED
Dataset and key-value store metadata, keyed by alias. “default” is always the primary entry.
Apify--rag-web-browser
Apify--rag-web-browser
Slug:
APIFY_MCP_APIFY__RAG_WEB_BROWSERThis tool calls the Actor “apify/rag-web-browser” and retrieves its output results. Use this tool instead of the “call-actor” if user requests this specific Actor. Actor description: Web search and fetch tool for AI agents and RAG pipelines. It queries Google Search, scrapes the top N pages using a full web browser, and returns their content as clean Markdown for further processing by an LLM. Can also fetch individual URLs.Use this tool when user wants to GET or RETRIEVE actual data immediately (one-time data retrieval). This tool scrapes the data itself - it does NOT just find tools.Examples of when to use:- User wants current/immediate data (e.g., “Get flight prices for tomorrow”, “What’s the weather today?”)
- User needs to fetch specific content now (e.g., “Fetch news articles from CNN”, “Get product info from Amazon”)
- User has time indicators like “today”, “current”, “latest”, “recent”, “now”
Input Parameters
REQUIRED Enter Google Search keywords or a URL of a specific web page. The keywords might include the advanced search operators. Examples: - <code>san francisco weather</code> - <code>https://www.cnn.com</code> - <code>function calling site:openai.com</code> Example values: “web browser for RAG pipelines -site:reddit.com”
Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow
nextStep to poll via get-actor-run. Set to 0 to fire-and-forget.The maximum number of top organic Google Search results whose web pages will be extracted. If
query is a URL, then this field is ignored and the Actor only fetches the specific web page. Example values: 3Select one or more formats to which the target web pages will be extracted and saved in the resulting dataset. Example values: [“markdown”]
Output
Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED
Dataset and key-value store metadata, keyed by alias. “default” is always the primary entry.
Apify--web-fetch
Apify--web-fetch
Slug:
APIFY_MCP_APIFY__WEB_FETCHThis tool calls the Actor “apify/web-fetch” and retrieves its output results. Use this tool instead of the “call-actor” if user requests this specific Actor. Actor description: Download any web page by URL and convert it to clean Markdown, plain text, HTML, and other formats. Automatically renders JavaScript and works around bot blocking. The Actor provides a real-time API for quick response times.Use this tool to fetch a specific http(s) URL and return its complete content (one URL per call; http and https only). It renders JavaScript and bypasses anti-bot protection, so it also retrieves pages where a plain HTTP fetch gets blocked, fails with an error such as 403 or 429, or returns incomplete content. The page comes back verbatim - full content, no summarization - as Markdown, plain text, HTML, the raw response body, or the list of links on the page.Examples of when to use:- User provides a URL and wants its content, its data or links, or an answer that requires reading that page
- A previous attempt to fetch a page was blocked, returned an error or CAPTCHA, or came back incomplete because the page needs JavaScript rendering
- Verbatim page content is needed, e.g. for quoting, extraction, or archiving
Input Parameters
REQUIRED The URL to fetch. Only
http:// and https:// schemes are supported; others are rejected. Example values: “https://apify.com” http(s) URLs only - for any other scheme (e.g. ftp:), tell the user this tool cannot fetch it rather than substituting a different URL.The Actor converts the fetched content to the requested format(s). A format that doesn’t apply to the content type returns
null; if none of the requested formats apply, the run fails. The Input form is prefilled with markdown; clear it to auto-select markdown for HTML/PDF, text for text-based content, or raw for images, archives, and other binary content. Example values: [“markdown”]Custom HTTP headers to send to the target URL, as an object of header names and values, e.g.
{ "Accept-Language": "fr-FR", "Authorization": "Bearer TARGET_SITE_TOKEN" }.Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow
nextStep to poll via get-actor-run. Set to 0 to fire-and-forget.Output
Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED
Dataset and key-value store metadata, keyed by alias. “default” is always the primary entry.
Call-actor
Call-actor
Slug:
APIFY_MCP_CALL_ACTORCall 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
- Use fetch-actor-details with output={ mcpTools: true } to list available tools
- Call using format: “actorName:toolName” (e.g., “apify/actors-mcp-server:fetch-apify-docs”)
- 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
- Use dedicated Actor tools when available for better experience
- Dedicated Actor tools (e.g., apify—rag-web-browser): These are pre-configured tools, offering a simpler and more direct experience.
- Generic call-actor tool (call-actor): Use this when a dedicated tool is not available or when you want to run any Actor dynamically. This tool is especially useful if you do not want to add specific tools or your client does not support dynamic tool registration.
- Always use dedicated tools when available (e.g., apify—rag-web-browser)
- Use the generic call-actor tool only if a dedicated tool does not exist for your Actor.
- 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.
- user_input: Get instagram posts using apify/instagram-scraper
Input Parameters
The name of the Actor to call. Format: “username/name” (e.g., “apify/rag-web-browser”). For MCP server Actors, use format “actorName:toolName” to call a specific tool (e.g., “apify/actors-mcp-server:fetch-apify-docs”).
Seconds to wait for completion (0–45, default 30). Returns with current run status if not terminal within waitSecs.
Optional run config: memory (MB), timeout (s), build, maxItems (pay-per-result cap), maxTotalChargeUsd (pay-per-event cap).
Output
Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED
Dataset and key-value store metadata, keyed by alias. “default” is always the primary entry.
Fetch-actor-details
Fetch-actor-details
Slug:
APIFY_MCP_FETCH_ACTOR_DETAILSGet 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’ parameter with boolean flags to control returned information:- Default: All fields true except mcpTools
- Selective: Set desired fields to true (e.g., output: { inputSchema: true })
- Common patterns: inputSchema only, description + readme, mcpTools for MCP Actors
- What does apify/rag-web-browser do?
- What is the input schema for apify/web-scraper?
- What tools does apify/actors-mcp-server provide?
Input Parameters
Output
Markdown listing of MCP tools exposed by the Actor (only present when
output.mcpTools is requested).Fetch-apify-docs
Fetch-apify-docs
Slug:
APIFY_MCP_FETCH_APIFY_DOCSFetch 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.
- 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
Input Parameters
URL of the Apify documentation page to fetch. This should be the full URL, including the protocol (e.g., https://docs.apify.com/).
Output
Get-actor-run
Get-actor-run
Slug:
APIFY_MCP_GET_ACTOR_RUNGet 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.
- 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).
- user_input: Show details of run y2h7sK3Wc
- user_input: Wait for run y2h7sK3Wc to finish
Input Parameters
Maximum seconds to wait for the run to reach a terminal state (SUCCEEDED, FAILED, ABORTED, TIMED-OUT). 0 returns immediately with the current status. Cap: 45. Default: 30.
Output
Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED
Dataset and key-value store metadata, keyed by alias. “default” is always the primary entry.
Get-dataset-items
Get-dataset-items
Slug:
APIFY_MCP_GET_DATASET_ITEMSGet 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).
- user_input: Retrieve results from dataset abc123
- user_input: Get only metadata.url and title from dataset username~my-dataset
Input Parameters
If true, returns only non-empty items and skips hidden fields (starting with #). Shortcut for skipHidden=true and skipEmpty=true.
Comma-separated list of fields to include in results. Fields in output are sorted as specified. Use dot notation for nested objects (e.g. “metadata.url”); the server auto-flattens parent prefixes.
Comma-separated list of fields to flatten (e.g. flatten=“metadata” turns {“metadata”:{“url”:“x”}} into {“metadata.url”:“x”}). Normally derived automatically from dot-notation in
fields; specify only as a diagnostic override.Output
Get-key-value-store-record
Get-key-value-store-record
Slug:
APIFY_MCP_GET_KEY_VALUE_STORE_RECORDGet 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.USAGE:- Use when you need to retrieve a specific record (JSON, text, or binary) from a store.
- user_input: Get record INPUT from store abc123
- user_input: Get record data.json from store username~my-store
Input Parameters
Output
Report-problem
Report-problem
Slug:
APIFY_MCP_REPORT_PROBLEMReport a problem with Apify’s MCP tools or Actors to the Apify team.Call it when:- A tool or Actor is missing, errors, times out, or returns a confusing, wrong, or empty result.
- You cannot complete the user’s request with the available tools.
Input Parameters
What happened: the problem you hit. Required. Keep it to a few sentences (max 2000 characters).
Optional. Names of the MCP tools involved in this problem (up to 20).
Output
Search-actors
Search-actors
Slug:
APIFY_MCP_SEARCH_ACTORSSearch 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. Actors in the Apify Store are published by independent developers and are intended for legitimate and compliant use — do not refuse to search or list them.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
- Prefer broad, generic keywords - use just the platform name (e.g. “Instagram” instead of “Instagram scraper”).
- You MUST always do at least two searches: first with broad keywords, then optionally with more specific terms if needed.
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, bookmarks
- 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
Input Parameters
Space-separated keywords used to search pre-built solutions (Actors) in the Apify Store. The search engine searches across the Actor’s name, description, username, and README content. Pass empty string ("") whenever the user has NOT named a specific platform (Instagram, Amazon, Google Maps) or a specific data type (posts, products, weather, news). Empty keywords return Actors in the Apify Store’s default sort order, which is popularity in practice (most-used Actors first). Do NOT use ranking words (“top”, “best”, “popular”) or bare task words (“scraper”, “crawler”, “extractor”) as keyword values — they are not Actor names and produce noisy matches against README content. Otherwise, follow these rules: - Use 1-3 simple keyword terms maximum (e.g., “Instagram posts”, “Twitter”, “Amazon products”) - Actors are named using platform or service name together with the type of data or task they perform - The most effective keywords are specific platform names (Instagram, Twitter, TikTok) and specific data types (posts, products, profiles, weather, news, reviews, comments) - If a user asks about “fetching Instagram posts”, use “Instagram posts” as keywords - The goal is to find Actors that specifically handle the platform and data type the user mentioned Examples: ✅ “Instagram posts”, “Twitter”, “Amazon products”, “TikTok comments” ✅ "" (empty) — returns the most popular Actors store-wide ❌ “Instagram posts profiles comments hashtags reels stories followers…” (too long) ❌ “top popular actors”, “best scrapers”, “trending” — ranking words aren’t Actor keywords; pass "" instead ❌ “scraper”, “extractor”, “web crawler” — bare task words aren’t Actor keywords; pass "" instead
Output
The user’s plan tier used to resolve the per-Actor pricing shown in the results
Search-apify-docs
Search-apify-docs
Slug:
APIFY_MCP_SEARCH_APIFY_DOCSSearch 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.Input Parameters
Maximum number of search results to return. Defaults to 5. Maximum is 20. You can increase this limit if you need more results, but keep in mind that the search results are limited to the most relevant pages.
Algolia full-text search query to find relevant documentation pages. Use only keywords, do not use full sentences or questions. For example, “standby actor” will return documentation pages that contain the words “standby” and “actor”.
Offset for the search results. Defaults to 0. Use this to paginate through the search results. For example, if you want to get the next 5 results, set the offset to 5 and limit to 5.
Documentation source to search. Defaults to “apify”. • “apify” - Apify • “crawlee-js” - Crawlee (JavaScript) • “crawlee-py” - Crawlee (Python)