[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-94693":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":9,"totalLinesOfCode":9,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":9,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":16,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":19,"hasPages":19,"topics":9,"createdAt":9,"pushedAt":9,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":16,"starSnapshotCount":16,"syncStatus":24,"lastSyncTime":25,"discoverSource":26},94693,"apify-mcp-server","apify\u002Fapify-mcp-server","apify","The Apify MCP server enables your AI agents to extract data from social media, search engines, maps, e-commerce sites, or any other website using thousands of ready-made scrapers, crawlers, and automation tools available on the Apify Store.",null,"https:\u002F\u002Fgithub.com\u002Fapify\u002Fapify-mcp-server","TypeScript",3529,221,20,113,0,32,59.24,false,"main","2026-08-24 04:01:22","\u003Ch1 align=\"center\">\n    \u003Ca href=\"https:\u002F\u002Fmcp.apify.com\">\n        \u003Cpicture>\n            \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fapify\u002Fapify-mcp-server\u002Frefs\u002Fheads\u002Fmaster\u002Fdocs\u002Fapify_mcp_server_dark_background.png\">\n            \u003Cimg alt=\"Apify MCP Server\" src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fapify\u002Fapify-mcp-server\u002Frefs\u002Fheads\u002Fmaster\u002Fdocs\u002Fapify_mcp_server_white_background.png\" width=\"500\">\n        \u003C\u002Fpicture>\n    \u003C\u002Fa>\n    \u003Cbr>\n    \u003Csmall>\u003Ca href=\"https:\u002F\u002Fmcp.apify.com\">mcp.apify.com\u003C\u002Fa>\u003C\u002Fsmall>\n\u003C\u002Fh1>\n\n\u003Cp align=center>\n    \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@apify\u002Factors-mcp-server\" rel=\"nofollow\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@apify\u002Factors-mcp-server.svg\" alt=\"NPM latest version\" data-canonical-src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@apify\u002Factors-mcp-server.svg\" style=\"max-width: 100%;\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@apify\u002Factors-mcp-server\" rel=\"nofollow\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002F@apify\u002Factors-mcp-server.svg\" alt=\"Downloads\" data-canonical-src=\"https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002F@apify\u002Factors-mcp-server.svg\" style=\"max-width: 100%;\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fapify\u002Factors-mcp-server\u002Factions\u002Fworkflows\u002Fcheck.yaml\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fapify\u002Factors-mcp-server\u002Factions\u002Fworkflows\u002Fcheck.yaml\u002Fbadge.svg?branch=master\" alt=\"Build Status\" style=\"max-width: 100%;\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fsmithery.ai\u002Fserver\u002F@apify\u002Fmcp\">\u003Cimg src=\"https:\u002F\u002Fsmithery.ai\u002Fbadge\u002F@apify\u002Fmcp\" alt=\"smithery badge\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\nThe Apify Model Context Protocol (MCP) server at [**mcp.apify.com**](https:\u002F\u002Fmcp.apify.com) enables your AI agents to extract data from social media, search engines, maps, e-commerce sites, and any other website using thousands of ready-made scrapers, crawlers, and automation tools from [Apify Store](https:\u002F\u002Fapify.com\u002Fstore). It supports OAuth, allowing you to connect from clients like Claude.ai or Visual Studio Code using just the URL.\n\n> **🚀 Use the hosted Apify MCP Server!**\n>\n> For the best experience, connect your AI assistant to our hosted server at **[`https:\u002F\u002Fmcp.apify.com`](https:\u002F\u002Fmcp.apify.com)**. The hosted server supports the latest features - including output schema inference for structured Actor results - that are not available when running locally via stdio.\n\n> ⚠️ **Legacy SSE transport removed.** The `https:\u002F\u002Fmcp.apify.com\u002Fsse` endpoint has been removed in favor of Streamable HTTP. Migrate your client to **[`https:\u002F\u002Fmcp.apify.com`](https:\u002F\u002Fmcp.apify.com)** — drop the `\u002Fsse` suffix from your configuration.\n\n💰 The server also supports [agentic payments](#-agentic-payments): buy a token from [AGI](#-agi-recommended) to run any Actor, or pay per-request via [direct x402](#-direct-x402) (Pay Per Event Actors only) or [Skyfire](#-skyfire).\n\nApify MCP Server is compatible with `Claude Code, Claude.ai, Cursor, VS Code` and any client that adheres to the Model Context Protocol.\nCheck out the [MCP clients section](#-mcp-clients) for more details or visit the [MCP configuration page](https:\u002F\u002Fmcp.apify.com).\n\n![Apify-MCP-server](https:\u002F\u002Fraw.githubusercontent.com\u002Fapify\u002Fapify-mcp-server\u002Frefs\u002Fheads\u002Fmaster\u002Fdocs\u002Fapify-mcp-server.png)\n\n## Table of Contents\n- [🌐 Introducing Apify MCP Server](#-introducing-apify-mcp-server)\n- [🚀 Quickstart](#-quickstart)\n- [🤖 MCP clients](#-mcp-clients)\n- [🪄 Try Apify MCP instantly](#-try-apify-mcp-instantly)\n- [💰 Agentic payments](#-agentic-payments)\n  - [How agentic payments work](#how-agentic-payments-work)\n  - [🪙 AGI (recommended)](#-agi-recommended)\n  - [💸 Direct x402](#-direct-x402)\n  - [🔥 Skyfire](#-skyfire)\n- [🛠️ Tools, resources, and prompts](#%EF%B8%8F-tools-resources-and-prompts)\n- [📊 Telemetry](#-telemetry)\n- [💬 Usage examples](#-usage-examples)\n- [🐛 Troubleshooting](#-troubleshooting)\n- [⚙️ Development](#%EF%B8%8F-development)\n- [🔒 Privacy policy](#-privacy-policy)\n- [🤝 Contributing](#-contributing)\n- [📚 Learn more](#-learn-more)\n\n# 🌐 Introducing Apify MCP Server\n\nThe Apify MCP Server allows an AI assistant to use any [Apify Actor](https:\u002F\u002Fapify.com\u002Fstore) as a tool to perform a specific task.\nFor example, it can:\n- Use [Facebook Posts Scraper](https:\u002F\u002Fapify.com\u002Fapify\u002Ffacebook-posts-scraper) to extract data from Facebook posts from multiple pages\u002Fprofiles.\n- Use [Google Maps Email Extractor](https:\u002F\u002Fapify.com\u002Flukaskrivka\u002Fgoogle-maps-with-contact-details) to extract contact details from Google Maps.\n- Use [Google Search Results Scraper](https:\u002F\u002Fapify.com\u002Fapify\u002Fgoogle-search-scraper) to scrape Google Search Engine Results Pages (SERPs).\n- Use [Instagram Scraper](https:\u002F\u002Fapify.com\u002Fapify\u002Finstagram-scraper) to scrape Instagram posts, profiles, places, photos, and comments.\n- Use [RAG Web Browser](https:\u002F\u002Fapify.com\u002Fapify\u002Frag-web-browser) to search the web, scrape the top N URLs, and return their content.\n\n**Video tutorial: Integrate 8,000+ Apify Actors and Agents with Claude**\n\n[![Apify MCP Server Tutorial: Integrate 5,000+ Apify Actors and Agents with Claude](https:\u002F\u002Fimg.youtube.com\u002Fvi\u002FBKu8H91uCTg\u002Fhqdefault.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=BKu8H91uCTg)\n\n# 🚀 Quickstart\n\nYou can use the Apify MCP Server in two ways:\n\n**HTTPS Endpoint (mcp.apify.com)**: Connect from your MCP client via OAuth or by including the `Authorization: Bearer \u003CAPIFY_TOKEN>` header in your requests. This is the recommended method for most use cases. Because it supports OAuth, you can connect from clients like [Claude.ai](https:\u002F\u002Fclaude.ai) or [Visual Studio Code](https:\u002F\u002Fcode.visualstudio.com\u002F) using just the URL: `https:\u002F\u002Fmcp.apify.com`.\n- `https:\u002F\u002Fmcp.apify.com` streamable transport\n\n**Standard Input\u002FOutput (stdio)**: Ideal for local integrations and command-line tools like the Claude for Desktop client.\n- Set the MCP client server command to `npx @apify\u002Factors-mcp-server` and the `APIFY_TOKEN` environment variable to your Apify API token.\n- See `npx @apify\u002Factors-mcp-server --help` for more options.\n\nYou can find detailed instructions for setting up the MCP server in the [Apify documentation](https:\u002F\u002Fdocs.apify.com\u002Fplatform\u002Fintegrations\u002Fmcp).\n\n# 🤖 MCP clients\n\nApify MCP Server is compatible with any MCP client that adheres to the [Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.org\u002F), but the level of support for dynamic tool discovery and other features may vary between clients.\n\u003C!--Therefore, the server uses [mcp-client-capabilities](https:\u002F\u002Fgithub.com\u002Fapify\u002Fmcp-client-capabilities) to detect client capabilities and adjust its behavior accordingly.-->\n\nTo interact with the Apify MCP Server, you can use clients such as [Claude Desktop](https:\u002F\u002Fclaude.ai\u002Fdownload), [Visual Studio Code](https:\u002F\u002Fcode.visualstudio.com\u002F), or [Apify Tester MCP Client](https:\u002F\u002Fapify.com\u002Fjiri.spilka\u002Ftester-mcp-client).\n\nVisit [mcp.apify.com](https:\u002F\u002Fmcp.apify.com) to configure the server for your preferred client.\n\n![Apify-MCP-configuration-clients](https:\u002F\u002Fraw.githubusercontent.com\u002Fapify\u002Fapify-mcp-server\u002Frefs\u002Fheads\u002Fmaster\u002Fdocs\u002Fmcp-clients.png)\n\n### Tested clients\n\n- [Claude Desktop](https:\u002F\u002Fdocs.apify.com\u002Fplatform\u002Fintegrations\u002Fclaude-desktop)\n- Claude.ai (web)\n- [ChatGPT](https:\u002F\u002Fdocs.apify.com\u002Fplatform\u002Fintegrations\u002Fchatgpt)\n- VS Code (Genie)\n- Cursor\n- OpenCode\n- [Kiro](https:\u002F\u002Fkiro.dev)\n- [Apify Tester MCP Client](https:\u002F\u002Fapify.com\u002Fjiri.spilka\u002Ftester-mcp-client) — designed for testing Apify MCP servers\n\n\n# 🪄 Try Apify MCP instantly\n\nWant to try Apify MCP without any setup?\n\nCheck out [Apify Tester MCP Client](https:\u002F\u002Fapify.com\u002Fjiri.spilka\u002Ftester-mcp-client)\n\nThis interactive, chat-like interface provides an easy way to explore the capabilities of Apify MCP without any local setup.\nSign in with your Apify account and start experimenting with web scraping, data extraction, and automation tools!\n\nOr use the MCP bundle file (formerly known as Anthropic Desktop extension file, or DXT) for one-click installation: [Apify MCP Server MCPB file](https:\u002F\u002Fgithub.com\u002Fapify\u002Fapify-mcp-server\u002Freleases\u002Flatest\u002Fdownload\u002Fapify-mcp-server.mcpb)\n\n\n# 💰 Agentic payments\n\nYou can pay for Actor runs without an Apify API token using **AGI**, **direct x402**, or **Skyfire**.\n\n- **AGI** ([agi.apify.com](https:\u002F\u002Fagi.apify.com)) mints a prepaid Apify API token in exchange for an x402 or MPP payment. Use the token like a normal API token against `mcp.apify.com` and `api.apify.com` — works for any Actor, not just Pay Per Event ones. **Recommended** for new integrations; see [AGI (recommended)](#-agi-recommended) below.\n- **Direct x402** pays with USDC on [Base](https:\u002F\u002Fbase.org) per request and does not require a separate platform account. It is fully supported by [`mcpc`](https:\u002F\u002Fgithub.com\u002Fapify\u002Fmcpc) (`brew install apify\u002Ftap\u002Fmcpc` or `npm install -g @apify\u002Fmcpc`). We use `mcpc` because it is one of the few MCP clients that supports the latest features and the x402 protocol natively.\n- **Skyfire** pays with PAY tokens and requires a Skyfire account with a funded wallet. It does not require a special MCP client; the entire payment flow is handled directly through the MCP tool call parameters.\n\n> ℹ️ **Scope:** Both direct x402 and Skyfire are limited to Pay Per Event Actors, don't support Standby Actors, and settle per run instead of minting a token.\n\n## How agentic payments work\n\nActor run costs vary, so both payment methods use a prepaid balance model. The payment flow happens in four steps:\n\n1. **Discovery**: The agent discovers Actors with `search-actors` or `fetch-actor-details`. Those calls are free.\n2. **Prepayment**: Before running a paid Actor tool, the agent funds a prepaid balance.\n   - **Direct x402**: `mcpc` automatically signs a $1.00 USDC transaction.\n   - **Skyfire**: The agent creates a PAY token (minimum $5.00) using Skyfire's `create-pay-token` tool.\n3. **Execution**: The agent calls the Actor tool.\n   - **Direct x402**: Handled automatically by `mcpc` using the prepaid balance.\n   - **Skyfire**: The agent explicitly passes the PAY token in the `skyfire-pay-id` input property.\n4. **Resolution**: The tool returns the Actor results. Unused funds stay available for later runs.\n   - **Direct x402**: After 60 minutes of inactivity, the server refunds any unused balance to the wallet on [Base](https:\u002F\u002Fbase.org).\n   - **Skyfire**: Skyfire returns unused funds when the token expires.\n\n## 🪙 AGI (recommended)\n\n[AGI](https:\u002F\u002Fagi.apify.com) (Apify Agent General Interface) is the recommended way for autonomous agents to pay for Apify usage without an account. Pay once via x402 or MPP, receive a prepaid, spend-capped Apify API token, and use it directly against `mcp.apify.com` and `api.apify.com` (`Authorization: Bearer \u003Ctoken>`) — for any Actor.\n\nFull protocol, supported payment methods, and current terms (minimum amount, token lifetime, refund policy) are documented at **[agi.apify.com\u002FAGENTS.md](https:\u002F\u002Fagi.apify.com\u002FAGENTS.md)** — treat it as the single source of truth.\n\n## 💸 Direct x402\n\nThe [x402 protocol](https:\u002F\u002Fwww.x402.org\u002F) enables direct, machine-to-machine payments. Your MCP client can use it to pay for Actor runs with USDC on the [Base blockchain](https:\u002F\u002Fbase.org\u002F), completely bypassing the need for an Apify API token.\n\n### Prerequisites\n\n- A wallet with USDC on [Base](https:\u002F\u002Fbase.org) mainnet.\n\n### Setup\n\nCreate or import a wallet:\n\n```bash\n# Create a new wallet\nmcpc x402 init\n\n# Import an existing wallet\nmcpc x402 import \u003Cprivate-key>\n\n# Show the wallet address and a funding QR code, so you can fund it with USDC on Base (https:\u002F\u002Fbase.org)\nmcpc x402\n```\n\nConnect to the server with x402 enabled:\n\n```bash\nmcpc connect \"mcp.apify.com?payment=x402\" @apify --x402\n```\n\nYou can now call a paid tool:\n\n```bash\nmcpc @apify tools-call call-actor actor:=\"apify\u002Frag-web-browser\" input:='{\"query\": \"latest AI news\"}'\n```\n\n## 🔥 Skyfire\n\n[Skyfire](https:\u002F\u002Fwww.skyfire.xyz\u002F) provides managed payment infrastructure for AI agents. Instead of authenticating with an Apify API token, your agent passes a Skyfire payment token to cover the cost of each tool call using PAY tokens.\n\n### Prerequisites\n\n- A [Skyfire account](https:\u002F\u002Fwww.skyfire.xyz\u002F) with a funded wallet.\n- An MCP client that supports multiple servers, such as Claude Desktop, OpenCode, or VS Code.\n\n### Setup\n\nConfigure the Skyfire MCP server and the Apify MCP Server in your client. Add `payment=skyfire` to the Apify server URL:\n\n```json\n{\n  \"mcpServers\": {\n    \"skyfire\": {\n      \"url\": \"https:\u002F\u002Fapi.skyfire.xyz\u002Fmcp\u002Fsse\",\n      \"headers\": {\n        \"skyfire-api-key\": \"\u003CYOUR_SKYFIRE_API_KEY>\"\n      }\n    },\n    \"apify\": {\n      \"url\": \"https:\u002F\u002Fmcp.apify.com?payment=skyfire\"\n    }\n  }\n}\n```\n\nSee the [Skyfire integration documentation](https:\u002F\u002Fdocs.apify.com\u002Fplatform\u002Fintegrations\u002Fskyfire) for setup details. The [Agentic Payments with Skyfire](https:\u002F\u002Fblog.apify.com\u002Fagentic-payments-skyfire\u002F) post provides additional background.\n\n# 🛠️ Tools, resources, and prompts\n\nThe MCP server provides a set of tools for interacting with Apify Actors.\nSince Apify Store is large and growing rapidly, the MCP server provides a way to dynamically discover and use new Actors.\n\n### Actors\n\nAny [Apify Actor](https:\u002F\u002Fapify.com\u002Fstore) can be used as a tool.\nBy default, the server is pre-configured with one Actor, `apify\u002Frag-web-browser`, and several helper tools.\nThe MCP server loads an Actor's input schema and creates a corresponding MCP tool.\nThis allows the AI agent to know exactly what arguments to pass to the Actor and what to expect in return.\n\n\nFor example, for the `apify\u002Frag-web-browser` Actor, the input parameters are:\n\n```json\n{\n  \"query\": \"restaurants in San Francisco\",\n  \"maxResults\": 3\n}\n```\nYou don't need to manually specify which Actor to call or its input parameters; the LLM handles this automatically.\nWhen a tool is called, the arguments are automatically passed to the Actor by the LLM.\nYou can refer to the specific Actor's documentation for a list of available arguments.\n\n### Helper tools\n\nOne of the most powerful features of using MCP with Apify is dynamic tool discovery.\nIt allows an AI agent to find new tools (Actors) as needed and incorporate them.\nHere are some special MCP operations and how the Apify MCP Server supports them:\n\n- **Apify Actors**: Search for Actors, view their details, and use them as tools for the AI.\n- **Apify documentation**: Search the Apify documentation and fetch specific documents to provide context to the AI.\n- **Actor runs**: Get lists of your Actor runs, inspect their details, and retrieve logs.\n- **Apify storage**: Access data from your datasets and key-value stores.\n\n### Overview of available tools\n\nHere is an overview list of all the tools provided by the Apify MCP Server.\n\nLegend for the **Enabled by default** column:\n- ✅ — in the default tool set.\n- ⚡ — auto-injected when `call-actor`, an Actor tool, or `get-actor-run` is present (which is true in the default configuration).\n- ✅¹ — served by default, but only when telemetry is enabled and the client is not withheld: Anthropic surfaces (Claude.ai \u002F Claude Desktop \u002F Claude Code) or `local-agent-mode-apify`. To disable, pass an explicit `tools=` list that omits it.\n\n| Tool name | Category | Description | Enabled by default |\n| :--- | :--- | :--- | :---: |\n| `search-actors` | actors | Search for Actors in Apify Store. | ✅ |\n| `fetch-actor-details` | actors | Retrieve detailed information about a specific Actor, including its input schema, README (summary when available, full otherwise), pricing, and Actor output schema. | ✅ |\n| `call-actor` | actors | Call an Actor and get its run results. Use fetch-actor-details first to get the Actor's input schema. | ✅ |\n| `get-actor-run` | runs | Get detailed information about a specific Actor run. | ⚡ |\n| `get-dataset-items` | storage | Retrieve items from a dataset with support for filtering and pagination. | ⚡ |\n| `get-key-value-store-record`| storage | Get the value associated with a specific key in a key-value store. | ⚡ |\n| `abort-actor-run` | runs | Abort a running Actor run, optionally gracefully. | ⚡ |\n| `search-apify-docs` | docs | Search the Apify documentation for relevant pages. | ✅ |\n| `fetch-apify-docs` | docs | Fetch the full content of an Apify documentation page by its URL. | ✅ |\n| [`apify--rag-web-browser`](https:\u002F\u002Fapify.com\u002Fapify\u002Frag-web-browser) | Actor (see [tool configuration](#tools-configuration)) | An Actor tool to browse the web. | ✅ |\n| `report-problem` | dev | Report a problem with an Apify tool or Actor to the Apify team. | ✅¹ |\n| `get-actor-run-list` | runs | Get a list of an Actor's runs, filterable by status. |  |\n| `get-actor-log` | runs | Retrieve the logs for a specific Actor run. |  |\n| `get-dataset` | storage | Get metadata about a specific dataset. |  |\n| `get-dataset-schema` | storage | Generate a JSON schema from dataset items. |  |\n| `get-key-value-store` | storage | Get metadata about a specific key-value store. |  |\n| `get-key-value-store-keys`| storage | List the keys within a specific key-value store. |  |\n| `get-dataset-list` | storage | List all available datasets for the user. |  |\n| `get-key-value-store-list`| storage | List all available key-value stores for the user. |  |\n\n> **Note:**\n>\n> When `call-actor`, an Actor tool, or `get-actor-run` is present, the server auto-injects `get-actor-run`, `get-dataset-items`, `get-key-value-store-record`, and `abort-actor-run`.\n>\n> When you call an Actor — through `call-actor` or directly via an Actor tool (e.g., `apify--rag-web-browser`) — the response contains run metadata, storage IDs, and a `summary` + `nextStep`, but no dataset items. To fetch items, follow `nextStep` and call `get-dataset-items` (auto-injected), passing the `datasetId` returned from the call.\n\n### Tool annotations\n\nAll tools include metadata annotations to help MCP clients and LLMs understand tool behavior:\n\n- **`title`**: Short display name for the tool (e.g., \"Search Actors\", \"Call Actor\", \"apify\u002Frag-web-browser\")\n- **`readOnlyHint`**: `true` for tools that only read data without modifying state (e.g., `get-dataset`, `fetch-actor-details`)\n- **`openWorldHint`**: `true` for tools that access external resources outside the Apify platform (e.g., `call-actor` executes external Actors). Tools that interact only with the Apify platform (like `search-actors` or `fetch-apify-docs`) do not have this hint.\n\n### Tools configuration\n\nThe `tools` configuration parameter is used to specify loaded tools – either categories or specific tools directly, and Apify Actors. For example, `tools=storage,runs` loads two categories; `tools=call-actor` loads just one tool.\n\nWhen no query parameters are provided, the MCP server loads the following `tools` by default:\n\n- `actors`\n- `docs`\n- `apify\u002Frag-web-browser`\n\nIf the tools parameter is specified, only the listed tools or categories will be enabled – no default tools will be included.\n\n`report-problem` is served by default (subject to the gating in the footnote above) but lives in the `dev` category, so an explicit `tools=dev` selects it too. To disable it, pass an explicit `tools=` list that omits it (e.g. `tools=actors,docs`).\n\n> **Easy configuration:**\n>\n> Use the [UI configurator](https:\u002F\u002Fmcp.apify.com\u002F) to configure your server, then copy the configuration to your client.\n\n**Configuring the hosted server:**\n\nThe hosted server can be configured using query parameters in the URL. For example, to load the default tools, use:\n\n```\nhttps:\u002F\u002Fmcp.apify.com?tools=actors,docs,apify\u002Frag-web-browser\n```\n\n\nFor minimal configuration, if you want to use only a single Actor tool - without any discovery or generic calling tools, the server can be configured as follows:\n\n```\nhttps:\u002F\u002Fmcp.apify.com?tools=apify\u002Fmy-actor\n```\n\nThis setup exposes only the specified Actor (`apify\u002Fmy-actor`) as a tool. No other tools will be available.\n\n**Configuring the CLI:**\n\nThe CLI can be configured using command-line flags. For example, to load the same tools as in the hosted server configuration, use:\n\n```bash\nnpx @apify\u002Factors-mcp-server --tools actors,docs,apify\u002Frag-web-browser\n```\n\nThe minimal configuration is similar to the hosted server configuration:\n\n```bash\nnpx @apify\u002Factors-mcp-server --tools apify\u002Fmy-actor\n```\n\nAs above, this exposes only the specified Actor (`apify\u002Fmy-actor`) as a tool. No other tools will be available.\n\n> **⚠️ Important recommendation**\n>\n> **The default tools configuration may change in future versions.** When no `tools` parameter is specified, the server currently loads default tools, but this behavior is subject to change.\n>\n> **For production use and stable interfaces, always explicitly specify the `tools` parameter** to ensure your configuration remains consistent across updates.\n\n### UI mode configuration\n\nThe `ui` parameter enables [MCP Apps](https:\u002F\u002Fmcp.apify.com\u002F) widget rendering in tool responses. When enabled, tools like `search-actors` return interactive MCP App responses.\n\n**Configuring the hosted server:**\n\nEnable UI mode using the `ui` query parameter:\n\n```\nhttps:\u002F\u002Fmcp.apify.com?ui=true\n```\n\nYou can combine it with other parameters:\n\n```\nhttps:\u002F\u002Fmcp.apify.com?tools=actors,docs&ui=true\n```\n\n**Configuring the CLI:**\n\nThe CLI can be configured using command-line flags. For example, to enable UI mode:\n\n```bash\nnpx @apify\u002Factors-mcp-server --ui true\n```\n\nYou can also set it via the `UI_MODE` environment variable:\n\n```bash\nexport UI_MODE=true\nnpx @apify\u002Factors-mcp-server\n```\n\n### Backward compatibility\n\nThe v2 configuration preserves backward compatibility with v1 usage. Notes:\n\n- `actors` param (URL) and `--actors` flag (CLI) are still supported.\n  - Internally they are merged into `tools` selectors.\n  - Examples: `?actors=apify\u002Frag-web-browser` ≡ `?tools=apify\u002Frag-web-browser`; `--actors apify\u002Frag-web-browser` ≡ `--tools apify\u002Frag-web-browser`.\n- `enableAddingActors` (URL), `enable-adding-actors` (CLI), and the legacy `enableActorAutoLoading` alias have been removed. To call Actors dynamically, use `tools=call-actor` (included by default via the `actors` category). Any lingering raw value is ignored.\n- Defaults remain compatible: when no `tools` are specified, the server loads `actors`, `docs`, and `apify\u002Frag-web-browser`.\n  - If any `tools` are specified, the defaults are not added (same as v1 intent for explicit selection).\n- `call-actor` is now included by default via the `actors` category (additive change). To exclude it, specify an explicit `tools` list without `actors`.\n- `tools=add-actor`, `tools=experimental`, and `tools=preview` are retired: they are ignored and load no tools. Use `tools=call-actor` (or the default `actors` category) instead.\n\nExisting URLs and commands using `?actors=...` or `--actors` continue to work unchanged.\n\n### Prompts\n\nThe server provides a set of predefined example prompts to help you get started interacting with Apify through MCP. For example, there is a `GetLatestNewsOnTopic` prompt that allows you to easily retrieve the latest news on a specific topic using the [RAG Web Browser](https:\u002F\u002Fapify.com\u002Fapify\u002Frag-web-browser) Actor.\n\n### Resources\n\nThe server does not yet provide any resources.\n\n## 💬 Usage examples\n\nBelow are realistic examples showing how an AI assistant uses the Apify MCP Server tools.\n\n### Example 1: Search the web using RAG Web Browser\n\n**User prompt:**\n> Find the latest news about autonomous AI agents and summarize the key developments.\n\nThe AI assistant calls the pre-configured `apify--rag-web-browser` Actor tool to search the web and return content from top results.\nThe tool returns markdown content from the top 3 search results, which the AI assistant then summarizes for the user.\n\n### Example 2: Discover and run an Actor from Apify Store\n\n**User prompt:**\n> Scrape the top 10 restaurants in Prague from Google Maps with their contact details.\n\nThe AI assistant first searches for a suitable Actor, inspects its input schema, and then executes it.\nThe tool returns a preview of the scraped data including restaurant names, addresses, ratings, phone numbers, and websites.\n\n### Example 3: Retrieve and paginate through Actor run results\n\n**User prompt:**\n> Show me the next 10 results from that scraping run.\n\nThe AI assistant uses the dataset ID from the previous Actor run to fetch additional items.\nExpected output: The tool returns the next page of structured data items from the Actor's output dataset.\n\n## 📡 Telemetry\n\nThe Apify MCP Server collects telemetry data about tool calls to help Apify understand usage patterns and improve the service.\nBy default, telemetry is **enabled** for all tool calls.\n\nThe stdio transport also uses [Sentry](https:\u002F\u002Fsentry.io) for error tracking, which helps us identify and fix issues faster.\nSentry is automatically disabled when telemetry is opted out.\n\n### Opting out of telemetry\n\nYou can opt out of telemetry (including Sentry error tracking) by setting the `--telemetry-enabled` CLI flag to `false` or the `TELEMETRY_ENABLED` environment variable to `false`.\nCLI flags take precedence over environment variables.\n\n#### Examples\n\n**For the remote server (mcp.apify.com)**:\n```text\n# Disable via URL parameter\nhttps:\u002F\u002Fmcp.apify.com?telemetry-enabled=false\n```\n\n**For the local stdio server**:\n```bash\n# Disable via CLI flag\nnpx @apify\u002Factors-mcp-server --telemetry-enabled=false\n\n# Or set environment variable\nexport TELEMETRY_ENABLED=false\nnpx @apify\u002Factors-mcp-server\n```\n\n# ⚙️ Development\n\nPlease see the [CONTRIBUTING.md](.\u002FCONTRIBUTING.md) guide for contribution guidelines and commit message conventions.\n\nFor detailed development setup, project structure, and local testing instructions, see the [DEVELOPMENT.md](.\u002FDEVELOPMENT.md) guide.\n\n## Prerequisites\n\n- [Node.js](https:\u002F\u002Fnodejs.org\u002Fen) (v22 or higher)\n\nCreate an environment file, `.env`, with the following content:\n```text\nAPIFY_TOKEN=\"your-apify-token\"\n```\n\nBuild the `actors-mcp-server` package:\n\n```bash\npnpm run build\n```\n\n## Start HTTP streamable MCP server\n\nRun using Apify CLI:\n\n```bash\nexport APIFY_TOKEN=\"your-apify-token\"\nexport APIFY_META_ORIGIN=STANDBY\napify run -p\n```\n\nOnce the server is running, you can use the [MCP Inspector](https:\u002F\u002Fgithub.com\u002Fmodelcontextprotocol\u002Finspector) to debug the server exposed at `http:\u002F\u002Flocalhost:3001`.\n\n## Start standard input\u002Foutput (stdio) MCP server\n\nYou can launch the MCP Inspector with this command:\n\n```bash\nexport APIFY_TOKEN=\"your-apify-token\"\nnpx @modelcontextprotocol\u002Finspector node .\u002Fdist\u002Fstdio.js\n```\n\nUpon launching, the Inspector will display a URL that you can open in your browser to begin debugging.\n\n## Unauthenticated access\n\nWhen the `tools` query parameter includes only tools explicitly enabled for unauthenticated use, the hosted server allows access without an API token.\nCurrently allowed tools: `search-actors`, `fetch-actor-details`, `search-apify-docs`, `fetch-apify-docs`.\nExample: `https:\u002F\u002Fmcp.apify.com?tools=search-actors`.\n\n## 🐦 Canary PR releases\n\nApify MCP is split across two repositories: this repository for core MCP logic and the private `apify-mcp-server-internal` for the hosted server.\nChanges must be synchronized between both.\n\nTo create a canary release, add the `beta` tag to your PR branch.\nThis publishes the package to [pkg.pr.new](https:\u002F\u002Fpkg.pr.new\u002F) for staging and testing before merging.\nSee [the workflow file](.github\u002Fworkflows\u002Fpre_release.yaml) for details.\n\n## 🐋 Docker Hub integration\nThe Apify MCP Server is also available on [Docker Hub](https:\u002F\u002Fhub.docker.com\u002Fmcp\u002Fserver\u002Fapify-mcp-server\u002Foverview), registered via the [mcp-registry](https:\u002F\u002Fgithub.com\u002Fdocker\u002Fmcp-registry) repository. The entry in `servers\u002Fapify-mcp-server\u002Fserver.yaml` should be deployed automatically by the Docker Hub MCP registry (deployment frequency is unknown). **Before making major changes to the `stdio` server version, test it locally to ensure the Docker build passes.** To test, change the `source.branch` to your PR branch and run `task build -- apify-mcp-server`. For more details, see [CONTRIBUTING.md](https:\u002F\u002Fgithub.com\u002Fdocker\u002Fmcp-registry\u002Fblob\u002Fmain\u002FCONTRIBUTING.md).\n\n# 🐛 Troubleshooting\n\nFor step-by-step troubleshooting, see the [Claude Desktop integration guide](https:\u002F\u002Fdocs.apify.com\u002Fplatform\u002Fintegrations\u002Fclaude-desktop) in the Apify documentation.\n\n## 💡 Limitations\n\nThe Actor input schema is processed to be compatible with most MCP clients while adhering to [JSON Schema](https:\u002F\u002Fjson-schema.org\u002F) standards. The processing includes:\n- **Descriptions** are truncated to 500 characters (as defined in `MAX_DESCRIPTION_LENGTH`).\n- **Enum fields** are truncated to a maximum combined length of 2000 characters for all elements (as defined in `ACTOR_ENUM_MAX_LENGTH`).\n- **Required fields** are explicitly marked with a `REQUIRED` prefix in their descriptions for compatibility with frameworks that may not handle the JSON schema properly.\n- **Nested properties** are built for special cases like proxy configuration and request list sources to ensure the correct input structure.\n- **Array item types** are inferred when not explicitly defined in the schema, using a priority order: explicit type in items > prefill type > default value type > editor type.\n- **Enum values and examples** are added to property descriptions to ensure visibility, even if the client doesn't fully support the JSON schema.\n- **Rental Actors** are only available for use with the hosted MCP server at https:\u002F\u002Fmcp.apify.com. When running the server locally via stdio, you can only access Actors that are already added to your local toolset. To dynamically search for and use any Actor from Apify Store—including rental Actors—connect to the hosted endpoint.\n\n# 🔒 Privacy policy\n\nWhen you use this server, your requests and Actor inputs are sent to the Apify API for execution.\nData is not shared with third parties beyond what is necessary to run the requested Actors.\nFor full details on data collection, usage, sharing, and retention, see [Apify Legal](https:\u002F\u002Fdocs.apify.com\u002Flegal).\n\n# 🤝 Contributing\n\nWe welcome bug reports, feature requests, and documentation fixes. **Send us the problem, not the patch** — a precise issue with a reproduction is more useful than a pull request.\n\n- **🐛 Report a bug**: [Open an issue](https:\u002F\u002Fgithub.com\u002Fapify\u002Fapify-mcp-server\u002Fissues) with a reproduction. The most useful thing you can send us.\n- **💡 Propose a feature**: [Open an issue](https:\u002F\u002Fgithub.com\u002Fapify\u002Fapify-mcp-server\u002Fissues) — the problem and who hits it, not the implementation.\n- **🔧 Code**: Work only on a maintainer-invited issue. An open issue is not an invitation to pick it up; unsolicited pull requests are closed.\n- **📚 Documentation**: Typos, broken links, and wrong commands go straight to a PR.\n\nFull rules, including [AI-assisted contributions](.\u002FCONTRIBUTING.md#ai-assisted-contributions): [CONTRIBUTING.md](.\u002FCONTRIBUTING.md).\n\n# 📚 Learn more\n\n- [Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.org\u002F)\n- [What are AI Agents?](https:\u002F\u002Fblog.apify.com\u002Fwhat-are-ai-agents\u002F)\n- [What is MCP and why does it matter?](https:\u002F\u002Fblog.apify.com\u002Fwhat-is-model-context-protocol\u002F)\n- [How to use MCP with Apify Actors](https:\u002F\u002Fblog.apify.com\u002Fhow-to-use-mcp\u002F)\n- [Tester MCP Client](https:\u002F\u002Fapify.com\u002Fjiri.spilka\u002Ftester-mcp-client)\n- [Webinar: Building and Monetizing MCP Servers on Apify](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=w3AH3jIrXXo)\n- [How to build and monetize an AI agent on Apify](https:\u002F\u002Fblog.apify.com\u002Fhow-to-build-an-ai-agent\u002F)\n- [Connect Apify MCP with Claude Desktop](https:\u002F\u002Fdocs.apify.com\u002Fplatform\u002Fintegrations\u002Fclaude-desktop)\n- [Connect Apify MCP with ChatGPT](https:\u002F\u002Fdocs.apify.com\u002Fplatform\u002Fintegrations\u002Fchatgpt)\n","Apify MCP Server 是一个为 AI 代理提供网页数据提取能力的 Model Context Protocol（MCP）兼容服务。它通过接入 Apify Store 中数千个预构建的爬虫、抓取器和自动化工具，支持从社交媒体、搜索引擎、地图、电商网站等任意网页高效获取结构化数据；内置 OAuth 认证、Streamable HTTP 流式传输及 agentic 支付机制（如 x402、Skyfire），并支持输出 Schema 自动推断。适用于需要将实时网络数据动态注入 AI 工作流的场景，例如智能客服知识更新、市场竞品监控、研究型 AI 助手的数据增强等。",2,"2026-08-14 02:30:05","trending"]