Test the MCP Playwright server and its tools in a disposable, cloud-based Room:

​
1. Install Meshagent CLI

pip install "meshagent[all]"

​
2. Sign Up & Authenticate

​
3. Start the MCP Playwright Server in a Room

meshagent service test --room=test --role=agent --image=meshagent/mcp-playwright:latest --env MESHAGENT_PORT=8001  --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" --name=mcp-playwright-service-test
  • This starts a Meshagent Room with the Playwright MCP server available.
  • The Room (and all running services) will clean up automatically if left inactive.

​
4. Launch a Chatbot with Playwright Toolkit in the Room

meshagent chatbot join --room=test --agent-name=mcp-playwright --name=mcp-playwright --toolkit=mcp-playwright
  • This starts a chatbot in the Room, with access to the Playwright tool suite.
  • Multiple toolkits can be made available to the same agent in a Room.
  • The output of this command will include a join link for the Room.

​
5. Try it Out!

  • Open the Room invitation link in your browser.
  • Send a message to the mcp-playwright agent and interact with the Playwright server tools live!

​
Project-Level Deployment (Persistent Services)

To make the MCP Playwright server and chatbot available in every Room created in your Meshagent project (ideal for production):

​
1. Deploy the Playwright MCP Service Globally

meshagent service create --role=agent --image=meshagent/mcp-playwright:latest --env MESHAGENT_PORT=8001  --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" --name=mcp-playwright-service

​
2. Deploy a Chatbot Service with Playwright Toolkit

meshagent service create --image="meshagent/cli:latest" --port="num=9001 path=/agent liveness=/ type=meshagent.callable participant_name=mcp-playwright-chatbot" --env="MESHAGENT_PORT=9001" --name="mcp-playwright-chatbot-service" --command="meshagent chatbot service --agent-name=mcp-playwright-chatbot --toolkit=mcp-playwright"
  • These services join every Room in your project on creation.
  • No need to run the MCP server/chatbot locally or as one-off processes!
  • Tools and chatbots are always present for users as soon as they enter a Room.

​
Tools Available

​
Tools Summary

The following tools are available via the Playwright MCP server, empowering agents and chatbots to interact with browsers programmatically:
ToolShort Description
browser_clickClick
browser_closeClose browser
browser_console_messagesGet console messages
browser_dragDrag mouse
browser_file_uploadUpload files
browser_generate_playwright_testGenerate a Playwright test
browser_handle_dialogHandle a dialog
browser_hoverHover mouse
browser_installInstall the browser specified in the config
browser_navigateNavigate to a URL
browser_navigate_backGo back
browser_navigate_forwardGo forward
browser_network_requestsList network requests
browser_pdf_saveSave as PDF
browser_press_keyPress a key
browser_resizeResize browser window
browser_select_optionSelect option
browser_snapshotPage snapshot
browser_tab_closeClose a tab
browser_tab_listList tabs
browser_tab_newOpen a new tab
browser_tab_selectSelect a tab
browser_take_screenshotTake a screenshot
browser_typeType text
browser_wait_forWait for

​
Tools Details

​
browser_click

Perform click on a web page
Parameters:
  • element (string): Human-readable description
  • ref (string): Target element reference

​
browser_close

Close the page

​
browser_console_messages

Returns all console messages

​
browser_drag

Drag and drop between two elements
Parameters:
  • endElement, endRef: Target description and reference
  • startElement, startRef: Source description and reference

​
browser_file_upload

Upload file(s)
Parameters:
  • paths (array): Absolute paths to files (single or multiple)

​
browser_generate_playwright_test

Generate Playwright test
Parameters:
  • description (string): Test description
  • name (string): Test name
  • steps (array): Test steps

​
browser_handle_dialog

Handle dialog (accept/prompt)
Parameters:
  • accept (boolean): Accept dialog
  • promptText (string, optional): Prompt text

​
browser_hover

Hover over element
Parameters:
  • element (string): Human-readable description
  • ref (string): Target element reference

​
browser_install

Install browser specified in config

​
browser_navigate

Navigate to URL
Parameters:
  • url (string): URL to navigate

​
browser_navigate_back

Go back

​
browser_navigate_forward

Go forward

​
browser_network_requests

List all network requests

​
browser_pdf_save

Save page as PDF
Parameters:
  • filename (string, optional): PDF file name (defaults supplied)

​
browser_press_key

Press keyboard key
Parameters:
  • key (string): Name or character

​
browser_resize

Resize browser window
Parameters:
  • height, width (number): Dimensions

​
browser_select_option

Select dropdown option(s)
Parameters:
  • element (string), ref (string): Dropdown reference
  • values (array): Option values

​
browser_snapshot

Accessibility snapshot of current page

​
browser_tab_close

Close a tab
Parameters:
  • index (number, optional): Tab index

​
browser_tab_list

List browser tabs

​
browser_tab_new

Open new tab
Parameters:
  • url (string, optional): Optional URL for new tab

​
browser_tab_select

Select tab by index
Parameters:
  • index (number): Tab index

​
browser_take_screenshot

Take screenshot
Parameters:
  • element (string, optional): Element to screenshot
  • filename (string, optional): Screenshot file name
  • raw (boolean, optional): PNG (raw) output
  • ref (string, optional): Element reference

​
browser_type

Type text
Parameters:
  • element, ref (string): Target element
  • text (string): Text to type
  • slowly (boolean, optional): One character at a time
  • submit (boolean, optional): Press Enter after

​
browser_wait_for

Wait for text or delay
Parameters:
  • text (string, optional): Wait for text to appear
  • textGone (string, optional): Wait for text to disappear
  • time (number, optional): Wait in seconds

​
More Information & Resources

For further details, usage patterns, and troubleshooting, please review the full Meshagent documentation and Playwright MCP server repository.