Browser

MCP server for headless browser automation powered by Playwright. Navigate web pages, interact with elements, fill forms, take screenshots, and extract structured content. Runs a real Chromium browser instance with full JavaScript support.

Useful for web scraping, automated testing, capturing page screenshots for review, filling out web forms, extracting data from dynamic single-page applications, and monitoring web applications.

Install

amodal install mcp browser

Tools exposed

• navigate — Navigate to a URL. Waits for the page to load (configurable wait: load, domcontentloaded, networkidle). Returns page title and final URL after redirects.
• screenshot — Capture a screenshot of the current page or a specific element. Returns a base64-encoded PNG. Supports full-page capture and custom viewport sizes.
• click — Click an element by CSS selector or text content. Waits for the element to be visible and clickable.
• fill — Fill a form field by CSS selector with a text value. Clears existing content first.
• select — Select an option from a dropdown by value, label, or index.
• get_text — Extract visible text content from the page or a specific element. Strips HTML tags and normalizes whitespace.
• get_html — Get the HTML source of the page or a specific element. Useful for structured data extraction.
• evaluate — Execute JavaScript in the browser context and return the result. For advanced extraction or interaction.
• wait_for — Wait for an element matching a selector to appear, disappear, or become visible. Configurable timeout.

Configuration

env:
  MCP_BROWSER_HEADLESS: "true"
  MCP_BROWSER_VIEWPORT_WIDTH: "1280"
  MCP_BROWSER_VIEWPORT_HEIGHT: "720"

• MCP_BROWSER_HEADLESS — Run in headless mode. Defaults to true. Set to false for debugging.
• MCP_BROWSER_VIEWPORT_WIDTH — Browser viewport width in pixels. Defaults to 1280.
• MCP_BROWSER_VIEWPORT_HEIGHT — Browser viewport height in pixels. Defaults to 720.
• MCP_BROWSER_TIMEOUT — Default navigation timeout in milliseconds. Defaults to 30000.

Example usage

• "Go to our staging site and take a screenshot of the dashboard page"
• "Scrape the pricing table from competitor.com and put it in a spreadsheet"
• "Fill out the contact form on our website with test data and submit it"
• "Extract all product names and prices from this e-commerce category page"