Puppeteer Vision Mcp Server

What is Puppeteer vision MCP Server?

This Model Context Protocol (MCP) server provides a tool for scraping webpages and converting them to markdown format using Puppeteer, Readability, and Turndown. It features AI-driven interaction capabilities to automatically handle cookies, captchas, and other interactive elements. It is intended for developers and LLM orchestrators that need structured web content.

How to use Puppeteer vision MCP Server?

Run the server directly via npx -y puppeteer-vision-mcp-server after setting required environment variables (e.g., OPENAI_API_KEY). It can also be configured as an MCP tool in an orchestrator using the JSON snippet provided in the README. Transport can be stdio (default), SSE, or HTTP, selected via the TRANSPORT_TYPE variable.

Key features of Puppeteer vision MCP Server

• Scrapes webpages using Puppeteer with stealth mode
• AI‑powered handling of cookies, CAPTCHAs, and overlays
• Extracts main content with Mozilla's Readability
• Converts HTML to well‑formatted Markdown with Turndown
• Supports code blocks and tables with custom rules
• Option to view browser interaction by disabling headless mode

Use cases of Puppeteer vision MCP Server

• Scrape news articles that require dismissing cookie consent banners
• Extract documentation or blog posts from pages with paywalls or login prompts
• Capture structured content (code blocks, tables) from dynamic web pages
• Feed cleaned Markdown into an LLM for further processing or summarization

FAQ from Puppeteer vision MCP Server

What AI model does it use?

It requires an OpenAI API key; the default vision model is gpt-4.1. You can change the model via the VISION_MODEL environment variable, and point to alternative providers by setting API_BASE_URL.

How do I see the browser during scraping?

Set the environment variable DISABLE_HEADLESS=true to run the browser in visible (non‑headless) mode.

What transport modes are supported?

Three modes are supported: stdio (default), sse, and http. Set the TRANSPORT_TYPE environment variable to switch between them.

Can I use a different AI provider?

Yes, set the API_BASE_URL environment variable to any OpenAI‑compatible