Skip to main content
This guide covers the available options and best practices for configuring Browseagent effectively.

​
Command Line Flags

All available command line options for customizing server behavior:
FlagDescriptionDefaultExample
--debugEnable detailed loggingfalse--debug
--port <number>WebSocket port for extension8765--port 9000
--config <path>Configuration file pathNone--config ./config.json
--stdioForce STDIO modeAuto-detected--stdio
--websocketForce WebSocket mode (dev)false--websocket

​
Basic Command Line Examples

{
  "mcpServers": {
    "browseagent": {
      "command": "npx",
      "args": ["@browseagent/mcp@latest", "--debug"]
    }
  }
}

​
Creating a Configuration File

Create browseagent.config.json for advanced settings: 
{
  "debug": false,
  "port": 8765,
  "host": "127.0.0.1",
  "timeout": 30000,
  "heartbeatInterval": 30000,
  "connectionTimeout": 60000,
  "maxRetries": 3,
  "toolTimeout": 60000
}
Usage: 
{
  "mcpServers": {
    "browseagent": {
      "command": "npx",
      "args": ["@browseagent/mcp@latest", "--config", "./browseagent.config.json"]
    }
  }
}

​
Configuration Sections Explained

{
  "debug": false,           // Enable debug logging
  "port": 8765,            // WebSocket port
  "host": "127.0.0.1",     // Bind host
  "timeout": 30000         // Request timeout in milliseconds
}

​
Environment-Specific Configurations

Features:
  • Detailed debug logging
  • Extended timeouts
  • WebSocket mode for extension testing
{
  "mcpServers": {
    "browseagent-dev": {
      "command": "npx",
      "args": [
        "@browseagent/mcp@latest",
        "--debug",
        "--websocket",
        "--config", "./config/development.json"
      ]
    }
  }
}
Development Config File:
{
  "debug": true,
  "timeout": 120000,
  "toolTimeout": 120000
}
Features:
  • Optimized performance
  • Minimal logging
  • Error handling focus
{
  "mcpServers": {
    "browseagent-prod": {
      "command": "npx",
      "args": [
        "@browseagent/mcp@latest",
        "--config", "./config/production.json"
      ]
    }
  }
}
Production Config File:
{
  "debug": false,
  "logLevel": "warn",
  "timeout": 30000,
  "toolTimeout": 60000
}
Features:
  • WebSocket mode
  • Extended debugging
  • Test-specific settings
{
  "mcpServers": {
    "browseagent-test": {
      "command": "npx",
      "args": [
        "@browseagent/mcp@latest",
        "--websocket",
        "--debug",
        "--config", "./config/testing.json"
      ]
    }
  }
}

​
Multiple Server Instances

{
  "mcpServers": {
    "browseagent-main": {
      "command": "npx",
      "args": ["@browseagent/mcp@latest"]
    },
    "browseagent-dev": {
      "command": "npx",
      "args": [
        "@browseagent/mcp@latest",
        "--debug",
        "--port", "8766"
      ]
    },
    "browseagent-test": {
      "command": "npx",
      "args": [
        "@browseagent/mcp@latest",
        "--websocket",
        "--port", "8767"
      ]
    }
  }
}
Each instance can have different settings:Main Instance (Production-like):
{
  "browseagent-main": {
    "command": "npx",
    "args": ["@browseagent/mcp@latest", "--config", "./main.config.json"]
  }
}
Development Instance:
{
  "browseagent-dev": {
    "command": "npx",
    "args": [
      "@browseagent/mcp@latest",
      "--debug",
      "--port", "8766",
      "--config", "./dev.config.json"
    ]
  }
}

​
Performance Tuning

{
  "toolTimeout": 60000         // Tool execution timeout
}

​
Configuration Validation

# Test server startup with config
npx @browseagent/mcp@latest --config ./config.json --debug

​
Configuration Templates

{
  "port": 8765
}
⌘I