---
title: "Deploy Playwright browser (w/ MCP)"
description: "Private browser for Playwright scripts and AI agents (MCP), behind a token."
category: "Automation"
url: https://railway.com/deploy/playwright-browser-w-mcp
---

# Deploy Playwright browser (w/ MCP)

Private browser for Playwright scripts and AI agents (MCP), behind a token.

**[Deploy Playwright browser (w/ MCP) on Railway](https://railway.com/template/playwright-browser-w-mcp)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/playwright-browser-w-mcp/manifest.json

- **Creator:** AvgSoft
- **Category:** Automation

## Template content

### Playwright https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@76f321b/service-icons/playwright.svg

- **Image:** mcr.microsoft.com/playwright:v1.65.1-noble
- **Start command:** `/bin/bash -c "mkdir -p /opt/playwright && echo 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 | base64 -d | tar -xzf - -C /opt/playwright && exec /bin/bash /opt/playwright/start.sh"`
- **Health check:** /health

## Documentation

# Deploy and Host Playwright browser (w/ MCP) on Railway

A headless browser your Railway services share: scripts connect with Playwright, AI agents with Playwright MCP. It stays on the private network, behind a token generated per deploy.

Not affiliated with or endorsed by Microsoft.

![Playwright browser on Railway](https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@b8344f5/playwright/banner.png)

## About Hosting Playwright browser (w/ MCP)

The official Playwright 1.65.1 image with Chromium, Firefox and WebKit, on port 3000: `/playwright` for Playwright clients, `/mcp` for agents. Add it to the project that needs a browser: on its canvas, Add, then Template.

### Use it from a script

1. In your service's **Variables**, add `PLAYWRIGHT_WS_ENDPOINT` = `${{Playwright.PLAYWRIGHT_WS_ENDPOINT}}` (the address, token included).
2. Install `playwright-core` at the server's version, the value of `PLAYWRIGHT_VERSION` (1.65.1). A different minor version is refused with "Playwright version mismatch".
3. Connect:

```js
const { chromium } = require('playwright-core');
const browser = await chromium.connect(process.env.PLAYWRIGHT_WS_ENDPOINT);
const page = await browser.newPage();
await page.goto('https://example.com');
console.log(await page.title());
await browser.close();
```

Use `firefox.connect` or `webkit.connect` for the other engines. Python, Java and .NET clients take the same address.

### Use it from an AI agent

1. Add `PLAYWRIGHT_MCP_URL` = `${{Playwright.PLAYWRIGHT_MCP_URL}}` and `PLAYWRIGHT_TOKEN` = `${{Playwright.PLAYWRIGHT_TOKEN}}` to the agent's service.
2. Register the MCP server with the header `Authorization: Bearer YOUR_TOKEN`. Claude Code: `claude mcp add --transport http playwright "$PLAYWRIGHT_MCP_URL" --header "Authorization: Bearer $PLAYWRIGHT_TOKEN"`. Any MCP client that can send a header works the same way.

### Use it from outside Railway

1. Click **Playwright**, then **Settings**, **Networking**, **Generate Domain**, port 3000.
2. Connect to `wss://YOUR_DOMAIN/playwright?token=YOUR_TOKEN`, or MCP at `https://YOUR_DOMAIN/mcp` with the same Bearer header. Anyone with the token can use the browser, so keep it secret.

## Common Use Cases

- Scheduled scraping and checks
- Browser tools for AI agents
- Screenshots and PDFs from services

## Dependencies for Playwright browser (w/ MCP) Hosting

- Playwright

### Deployment Dependencies

- [Playwright remote connection](https://playwright.dev/docs/docker#remote-connection)
- [Playwright MCP](https://github.com/microsoft/playwright-mcp)

### Implementation Details

![Playwright browser architecture](https://cdn.jsdelivr.net/gh/mikedepo/railway-template-assets@b8344f5/playwright/architecture.png)

Nothing to back up. Idles at about 0.15 GB. On Free (0.5 GB) use Chromium: Firefox and WebKit need 1 GB for heavy pages. To upgrade, change the image tag and `PLAYWRIGHT_VERSION` together.

## Why Deploy Playwright browser (w/ MCP) on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Playwright browser (w/ MCP) on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

**Updated 2026-11-14:** first release, Playwright 1.65.1.


## Similar templates

- [N8N Main + Worker](https://railway.com/deploy/n8n-main-worker) — Deploy and Host N8N with Inactive worker.
- [Evolution API with n8n](https://railway.com/deploy/evolution-api-with-n8n) — Automate WhatsApp workflows with Evolution API, n8n, and Postgres.
- [Postgres Backup](https://railway.com/deploy/postgres-s3-backups) — Cron-based PostgreSQL backup to bucket storage

Open this page in a browser: https://railway.com/deploy/playwright-browser-w-mcp