Fourth Playwright

You can run the Fourth Playwright MCP Server to orchestrate browser automation with FastMCP v3 and expose MCP endpoints for clients. It includes an HTTP endpoint for remote MCP access and a local runtime option that you can start directly in your environment. This setup supports deployment to platforms like Railway and enables custom tools for authentication, navigation, and data extraction.

How to use

You will interact with the server through an MCP client. The server exposes an HTTP MCP endpoint at your chosen host and port, and you can start a local instance using a standard runtime command. Use the HTTP endpoint to connect your MCP client, and use the local start command to run the server in development or on your own infrastructure.

How to install

Prerequisites: make sure you have Python 3.11 or newer and Node.js 18 or newer installed on your system.

# Python dependencies
uv sync

# Node dependencies (installs @playwright/mcp + Chromium)
npm install

Additional sections

Run locally to start the MCP server and access health and MCP endpoints from your local machine.

Deployment notes: You can deploy this server to Railway. Railway can auto-detect the Dockerfile, set environment variables from a provided example, and assign PORT for you.

Claude.ai Custom Connector integration: configure an SSE URL for the MCP endpoint and set up OAuth with your client credentials to enable seamless access.

Configuration and tools

The server provides a set of custom tools to automate common Fourth tasks. These tools are accessible via the MCP interface after your client connects.

Available tools

fourth_login

Automated login with credentials or single sign-on to access protected Fourth resources.

fourth_navigate_module

Navigate to a Fourth module by its name, rendering the module view in the automated session.

fourth_extract_table

Extract structured data from tables present on the page and return it in a structured format.

fourth_extract_report

Generate a structured report from content found on the current page.

fourth_wait_for_load

Wait for the Fourth SPA to fully load using smart wait logic to avoid premature interactions.

fourth_get_user_context

Retrieve current user context, permissions, and restaurant information.