Puppeteer MCP
Pricing
Pay per usage
Puppeteer MCP
AI-powered browser automation via Model Context Protocol. Enable Claude, ChatGPT, and other AI assistants to control browsers, scrape data, and automate web tasks through natural language.
Pricing
Pay per usage
AI-powered browser automation via Model Context Protocol. Enable Claude, ChatGPT, and other AI assistants to control browsers, scrape data, and automate web tasks through natural language.
alwaysStoreContentbooleanOptional
Force all page content to be stored in the Actor's KeyValue Store, regardless of size. Returns a URL to access the stored content.
Default value of this property is false
alwaysStoreScreenshotsbooleanOptional
Force all screenshots to be stored in the Actor's KeyValue Store, regardless of size. Returns a URL to access the stored binary image.
Default value of this property is false
apiKeystringOptional
Optional API key for authentication. When set, all requests (except health checks) must include the X-API-Key header with this value. Minimum 8 characters for security.
apifyProxyCountryCodestringOptional
Two-letter ISO country code for Apify Proxy (e.g., 'US', 'DE', 'GB'). Requests will be routed through proxies in the specified country. Leave empty for automatic selection.
apifyProxyGroupsarrayOptional
Proxy groups to use with Apify Proxy. Common options: RESIDENTIAL (residential IPs, best for avoiding blocks), DATACENTER (faster, cheaper). Leave empty to use default datacenter proxies. Check your Apify proxy dashboard for available groups.
Default value of this property is []
compressionThresholdintegerOptional
Data larger than this size (in bytes) is automatically compressed with gzip before storing in KeyValue Store. Reduces storage costs and network transfer. Set to 0 to compress all data regardless of size. Lower values cause more aggressive compression.
Default value of this property is 102400
contentStorageThresholdintegerOptional
Page content (HTML/text) larger than this size (in bytes) is automatically stored in the Actor's KeyValue Store instead of returned inline. Stored with optional compression. Set to 0 to always return inline.
Default value of this property is 512000
defaultTimeoutintegerOptional
Default timeout for browser operations in milliseconds. Increase for slow-loading pages.
Default value of this property is 30000
enableLoggingbooleanOptional
Enable detailed logging for debugging. Logs are visible in the Actor run console.
Default value of this property is true
enableRateLimitingbooleanOptional
Enable rate limiting to protect the server from abuse. When enabled, requests are limited per IP address based on the configured rate.
Default value of this property is false
headlessModebooleanOptional
Run browser in headless mode (no visible UI). Recommended for production. Disable for debugging.
Default value of this property is true
idleShutdownMsintegerOptional
Time in milliseconds of inactivity before auto-shutdown. Set to 0 to disable. Helps reduce costs by shutting down when not in use.
Default value of this property is 120000
logLevelEnumOptional
Logging verbosity level. Use 'debug' for troubleshooting, 'info' for normal operation, 'warn' or 'error' for minimal output.
"debug": string"info": string"warn": string"error": stringDefault value of this property is "info"
maxConcurrencyintegerOptional
Maximum number of concurrent browser instances in the pool. Higher values use more memory but handle more simultaneous requests.
Default value of this property is 1
portstringOptional
Port for the MCP server to listen on. This is typically set automatically by Apify.
Default value of this property is "8080"
proxyUrlsarrayOptional
List of custom proxy URLs to use instead of Apify Proxy. Currently, all URLs must use the same proxy server (host:port) with different authentication credentials. Format: 'http://user:pass@host:port'. Session-based authentication will rotate through the provided credentials. Cannot be used together with Apify Proxy options.
Default value of this property is []
rateLimitRequestsPerMinuteintegerOptional
Maximum number of requests allowed per IP address per minute. Only applies when rate limiting is enabled.
Default value of this property is 100
screenshotStorageThresholdintegerOptional
Screenshots larger than this size (in bytes) are automatically stored in the Actor's KeyValue Store instead of returned inline. Stored as binary with optional compression. Set to 0 to always return inline.
Default value of this property is 102400
sessionTimeoutMsintegerOptional
Time in milliseconds before an idle browser session is automatically closed. Sessions are reused across tool calls.
Default value of this property is 1800000
useApifyProxybooleanOptional
Enable Apify Proxy for all browser requests. This helps avoid IP blocking and enables access to geo-restricted content. Requires an Apify subscription with proxy access.
Default value of this property is false
userAgentstringOptional
Browser user agent string. Leave empty for default Chrome user agent. Custom user agents can help avoid bot detection.
Default value of this property is ""