Browser Automation MCP Server

MCP (Model Context Protocol) server implementation for browser automation with debugging, security validation, visual testing, and testing framework integration.

Get Started View API GitHub

Platform Overview

Error Handling

Error handling, timeout management, and cross-platform compatibility.

Comprehensive Tools

Automation tools spanning navigation, interaction, debugging, security, monitoring, and testing.

Multi-Browser Support

Switch between Chromium, Firefox, and WebKit engines with state preservation.

Security & Validation

Security scanning, CSP handling, certificate management, and vulnerability detection.

Analytics

Performance monitoring, error tracking, usage analytics, and session journey analysis.

Testing Integration

Integration with Playwright Test, Jest, Mocha, and test reporting capabilities.

Feature Categories

Page Control (5 tools)

  • Navigation: Page loading, history management, URL handling, page reload
  • Screenshots: Full page and viewport capture with quality control

Element Interaction (7 tools)

  • User Actions: Clicking, typing, hovering, scrolling, key presses
  • Element Targeting: CSS selector-based interaction with timeout handling

Content Extraction (3 tools)

  • DOM Analysis: Page content, element information, title retrieval
  • Data Extraction: Structured content extraction from page elements

JavaScript Execution (3 tools)

  • Code Execution: JavaScript evaluation on page and element contexts
  • Dynamic Analysis: Runtime element inspection and manipulation

Synchronization (2 tools)

  • Wait Conditions: Element state waiting, navigation completion
  • Timing Control: Smart waiting for dynamic content and async operations

Console & Network (4 tools)

  • Console Monitoring: Real-time message capture and filtering
  • Network Monitoring: Request/response tracking with comprehensive analysis

Browser Configuration (4 tools)

  • Viewport Control: Dynamic viewport, user agent, geolocation configuration
  • Browser Lifecycle: Browser initialization and cleanup management

Multi-Browser (3 tools)

  • Engine Support: Chromium, Firefox, WebKit browser engines
  • Dynamic Switching: Runtime browser engine switching with state preservation

Debugging (4 tools)

  • Visual Debugging: Element highlighting, execution tracing
  • Performance Analysis: Timeline capture, debug mode with comprehensive logging

Security (3 tools)

  • Security Validation: CSP handling, certificate management
  • Vulnerability Assessment: Security scanning and compliance checking

Monitoring (4 tools)

  • Analytics: Usage tracking, error monitoring, performance analysis
  • Session Analysis: User journey tracking and behavioral insights

Visual Testing (5 tools)

  • Regression Testing: Screenshot comparison, cross-browser validation
  • Visual Analysis: Element-level comparison, comprehensive test reporting

Test Integration (4 tools)

  • Framework Adapters: Playwright, Jest, Mocha integration
  • Reporting: Test result aggregation, analytics, and trend analysis

Quick Start

Installation

Get started instantly with npx (recommended):

npx insite-mcp

Or install globally:

npm install -g insite-mcp

MCP Configuration

Add to your MCP client configuration (npx - recommended):

{
  "mcpServers": {
    "insite": {
      "command": "npx",
      "args": ["insite-mcp"]
    }
  }
}

Usage Examples

{
  "tools": [
    {
      "name": "load_page",
      "arguments": {
        "url": "https://example.com",
        "waitUntil": "networkidle"
      }
    },
    {
      "name": "wait_for_element",
      "arguments": {
        "selector": "#main-content"
      }
    },
    {
      "name": "screenshot",
      "arguments": {
        "fullPage": true,
        "quality": 90
      }
    }
  ]
}
{
  "tools": [
    {
      "name": "switch_browser",
      "arguments": {
        "engine": "firefox"
      }
    },
    {
      "name": "performance_monitoring",
      "arguments": {
        "action": "start_monitoring",
        "metrics": ["pageLoadTime", "firstContentfulPaint"]
      }
    },
    {
      "name": "visual_regression_testing",
      "arguments": {
        "action": "run_tests",
        "config": {
          "threshold": 0.1
        }
      }
    }
  ]
}
{
  "tools": [
    {
      "name": "playwright_test_adapter",
      "arguments": {
        "action": "configure",
        "config": {
          "testDir": "./e2e",
          "projects": [
            {"name": "chromium", "browser": "chromium"},
            {"name": "firefox", "browser": "firefox"}
          ]
        }
      }
    },
    {
      "name": "test_reporter",
      "arguments": {
        "action": "generate_report",
        "outputFormat": "html",
        "analytics": {
          "trends": true,
          "performance": true
        }
      }
    }
  ]
}

Key Features

Single MCP Server

Single server providing browser automation tools without needing multiple automation frameworks.

Error Handling

Error handling, timeout management, and cross-platform compatibility.

MCP Protocol

MCP protocol compliance enables integration with existing workflows and AI systems.

Built-in Monitoring

Built-in monitoring, performance analysis, and reporting capabilities.