WebInteractionTools is an MCP server that enables AI agents to interact with web pages programmatically. It exposes a set of browser automation capabilities via Playwright, including navigating to URLs, going back in history, taking screenshots of the current viewport, scrolling to specific positions, directions, or text, and executing arbitrary JavaScript on loaded pages. The available tools are: navigate (go to a URL with optional timeout and wait conditions), goBack (navigate to the previous page), screenshot (capture the current viewport image), scrollToPosition (scroll to a specific Y coordinate), scrollDirection (scroll up/down/top/bottom), scrollToText (find and scroll to specific text), and executeJavaScript (run custom JS on the page). Install and run the server, then add it to your Claude instance so your AI agents can call these tools as needed.

Prerequisites:

• Node.js and npm installed on your system (Node.js 14+ recommended).
• Optional: Claude integration setup if you’re connecting to Claude.

Installation steps:

1. Install the MCP server package globally: npm install -g @tcehjaava/webinteractiontools

2. Verify installation (example): webinteractiontools --help

3. Add the MCP server to Claude (example command shown in the README): claude mcp add webinteractiontools "webinteractiontools"

4. Start the server locally for development (from the project root or installed package): webinteractiontools

   or, if you’re using a built/dist version in development:

   node dist/index.js

5. If you’re developing the source, install dependencies and build first: npm install npm run build

   then run the built server

   node dist/index.js

Notes:

• The Quick Start demonstrates the server being installed globally and started via the CLI, or via a local build in development. Ensure the server is running before attempting to use it from Claude.

Tips and notes:

• The server uses Playwright under the hood to control a headful/headless browser for web interactions.
• When starting manually, you can use the provided CLI command (webinteractiontools) or the node dist/index.js entry point if you’re running a local build.
• If you encounter connectivity issues with Claude, ensure the MCP server is reachable at the expected endpoint and that any required environment variables are set.
• The npm package name to install is @tcehjaava/webinteractiontools; use claude mcp add to register the server with Claude as shown in the Quick Start.
• If you extend the server or change the entry point, update the mcp_config accordingly to point to the correct node script (path to server.js or dist/index.js).