@olib-ai/owl-browser-mcp 1.0.4 → 2.0.0

package/README.md

@@ -1,10 +1,10 @@
 # Owl Browser MCP Server
 
-MCP (Model Context Protocol) server for Owl Browser HTTP API. This server dynamically generates 144 browser automation tools from the embedded OpenAPI schema.
+MCP (Model Context Protocol) server for Owl Browser HTTP API. This server dynamically generates 157 browser automation tools from the embedded OpenAPI schema.
 
 ## Features
 
-- **144 Browser Tools**: Full browser automation including navigation, clicks, typing, screenshots, CAPTCHA solving, and more
+- **157 Browser Tools**: Full browser automation including navigation, clicks, typing, screenshots, CAPTCHA solving, and more
 - **Multiple Contexts**: Create and manage multiple isolated browser contexts (sessions)
 - **Anti-Detection**: Built-in fingerprint management, proxy support, and stealth features
 - **HTTP API Backend**: Connects to Owl Browser's HTTP server (Docker or standalone)
@@ -149,7 +149,7 @@ If running from source instead of npm:
 
 ## Available Tools
 
-The server exposes 144 tools organized by category:
+The server exposes 157 tools organized by category:
 
 ### Context Management
 - `browser_create_context` - Create isolated browser session
@@ -213,7 +213,7 @@ npx @modelcontextprotocol/inspector \
 ```
 
 The Inspector will open a web UI (default: http://localhost:6274) where you can:
-- Browse all 144 browser tools
+- Browse all 157 browser tools
 - Execute tools with custom parameters
 - View JSON responses in real-time
 

package/dist/index.js

@@ -20369,7 +20369,7 @@ var openapi_default = {
   info: {
     title: "Owl Browser API",
     description: "REST API for browser automation with anti-detection capabilities",
-    version: "1.1.0"
+    version: "1.0.4"
   },
   servers: [
     {
@@ -20427,17 +20427,18 @@ var openapi_default = {
                   },
                   profile_path: {
                     type: "string",
-                    description: "Path to a browser profile JSON file. If the file exists, loads fingerprints, cookies, and settings. If not, creates a new profile and saves it to this path. Useful for persistent browser sessions"
+                    description: "Path to a browser profile JSON file (or upload file via multipart/form-data). If the file exists, loads fingerprints, cookies, and settings. If not, creates a new profile and saves it to this path. Encrypted profiles (from browser_download_profile) are automatically detected and decrypted."
                   },
                   proxy_type: {
                     type: "string",
-                    description: "Type of proxy server to use. Options: 'http', 'https', 'socks4', 'socks5', 'socks5h'. Use 'socks5h' for remote DNS resolution (recommended for privacy)",
+                    description: "Type of proxy server to use. Options: 'http', 'https', 'socks4', 'socks5', 'socks5h', 'gae'. Use 'socks5h' for remote DNS resolution (recommended for privacy). Use 'gae' for private app proxy",
                     enum: [
                       "http",
                       "https",
                       "socks4",
                       "socks5",
-                      "socks5h"
+                      "socks5h",
+                      "gae"
                     ]
                   },
                   proxy_host: {
@@ -20464,6 +20465,10 @@ var openapi_default = {
                     type: "string",
                     description: "Path to custom CA certificate file (.pem, .crt, .cer) for SSL interception proxies. Required when using Charles Proxy, mitmproxy, or similar HTTPS inspection tools"
                   },
+                  proxy_ca_key_path: {
+                    type: "string",
+                    description: "Path to CA private key file for GAE/private app proxy MITM. Required for generating per-domain certificates when using 'gae' proxy type"
+                  },
                   proxy_trust_custom_ca: {
                     type: "boolean",
                     description: "Trust the custom CA certificate for SSL interception. Enable when using Charles Proxy, mitmproxy, or similar tools that intercept HTTPS traffic. Default: false"
@@ -20496,6 +20501,10 @@ var openapi_default = {
                   gpu: {
                     type: "string",
                     description: "Filter profiles by GPU vendor/model. If set, only profiles with matching GPU will be used. Examples: 'nvidia', 'amd', 'intel'"
+                  },
+                  timezone: {
+                    type: "string",
+                    description: "Override browser timezone. IANA timezone format (e.g., 'America/New_York', 'Europe/London', 'Asia/Tokyo'). If not set, falls back to: 1) proxy-detected timezone (if proxy configured with spoof_timezone), 2) VM profile timezone, 3) system default. This parameter works without proxy configuration."
                   }
                 }
               }
@@ -20609,12 +20618,13 @@ var openapi_default = {
                   },
                   wait_until: {
                     type: "string",
-                    description: "When to consider navigation complete: '' (return immediately, default), 'load' (wait for load event), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle)",
+                    description: "When to consider navigation complete: '' (return immediately, default), 'load' (wait for load event), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle), 'fullscroll' (scroll full page to trigger lazy loading, then scroll back to top)",
                     enum: [
                       "",
                       "load",
                       "domcontentloaded",
-                      "networkidle"
+                      "networkidle",
+                      "fullscroll"
                     ]
                   },
                   timeout: {
@@ -20667,12 +20677,13 @@ var openapi_default = {
                   },
                   wait_until: {
                     type: "string",
-                    description: "When to consider reload complete: '' (return immediately), 'load' (wait for load event, default), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle)",
+                    description: "When to consider reload complete: '' (return immediately), 'load' (wait for load event, default), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle), 'fullscroll' (scroll full page to trigger lazy loading, then scroll back to top)",
                     enum: [
                       "",
                       "load",
                       "domcontentloaded",
-                      "networkidle"
+                      "networkidle",
+                      "fullscroll"
                     ]
                   },
                   timeout: {
@@ -20720,12 +20731,13 @@ var openapi_default = {
                   },
                   wait_until: {
                     type: "string",
-                    description: "When to consider navigation complete: '' (return immediately), 'load' (wait for load event, default), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle)",
+                    description: "When to consider navigation complete: '' (return immediately), 'load' (wait for load event, default), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle), 'fullscroll' (scroll full page to trigger lazy loading, then scroll back to top)",
                     enum: [
                       "",
                       "load",
                       "domcontentloaded",
-                      "networkidle"
+                      "networkidle",
+                      "fullscroll"
                     ]
                   },
                   timeout: {
@@ -20773,12 +20785,13 @@ var openapi_default = {
                   },
                   wait_until: {
                     type: "string",
-                    description: "When to consider navigation complete: '' (return immediately), 'load' (wait for load event, default), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle)",
+                    description: "When to consider navigation complete: '' (return immediately), 'load' (wait for load event, default), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle), 'fullscroll' (scroll full page to trigger lazy loading, then scroll back to top)",
                     enum: [
                       "",
                       "load",
                       "domcontentloaded",
-                      "networkidle"
+                      "networkidle",
+                      "fullscroll"
                     ]
                   },
                   timeout: {
@@ -20980,7 +20993,7 @@ var openapi_default = {
     "/api/execute/browser_pick": {
       post: {
         summary: "Browser Pick",
-        description: "Select an option from a dropdown or select element. Works with native HTML <select> elements and dynamic/custom dropdowns (like select2, react-select). Specify the option by its value or visible text. Automatically handles opening the dropdown and selecting the option.",
+        description: "Select an option from a dropdown or select element. Works with native HTML select elements and dynamic/custom dropdowns (like select2, react-select). Specify the option by its value or visible text. Automatically handles opening the dropdown and selecting the option.",
         tags: [
           "General"
         ],
@@ -21001,7 +21014,7 @@ var openapi_default = {
                   },
                   value: {
                     type: "string",
-                    description: "The option to select. Can be the option's value attribute OR the visible display text. Works with both native <select> elements and dynamic dropdowns (select2, etc.)"
+                    description: "The option to select. Can be the option's value attribute OR the visible display text. Works with both native select elements and dynamic dropdowns (select2, etc.)"
                   }
                 },
                 required: [
@@ -21165,6 +21178,10 @@ var openapi_default = {
                   end_y: {
                     type: "number",
                     description: "Y coordinate (in pixels from top edge) where the drag ends (drop location)"
+                  },
+                  mid_points: {
+                    type: "string",
+                    description: "Optional array of intermediate [x, y] coordinates for the drag path. Creates a more realistic drag movement through multiple waypoints. Format: [[x1, y1], [x2, y2], ...]. Example: [[300, 200], [400, 250]]"
                   }
                 },
                 required: [
@@ -21277,6 +21294,10 @@ var openapi_default = {
                   steps: {
                     type: "number",
                     description: "Number of intermediate points along the path. More steps = smoother movement. Default: auto-calculated based on distance. Recommended: 0 for auto, or 10-50 for custom"
+                  },
+                  stop_points: {
+                    type: "string",
+                    description: "Optional array of [x, y] coordinates where the cursor pauses briefly (50-150ms). Useful for simulating human hesitation or visual scanning behavior. Format: [[x1, y1], [x2, y2], ...]. Example: [[200, 150], [350, 250]]"
                   }
                 },
                 required: [
@@ -21679,7 +21700,7 @@ var openapi_default = {
                   },
                   file_paths: {
                     type: "string",
-                    description: `Array of absolute file paths to upload, as JSON array string (e.g., '["/path/to/file1.pdf", "/path/to/file2.jpg"]')`
+                    description: "Array of file paths to upload. Can be a JSON array string or actual array. For JSON input use server paths. For multipart upload, files are saved to temp paths automatically."
                   }
                 },
                 required: [
@@ -22299,8 +22320,8 @@ var openapi_default = {
                     description: "CSS selector or natural language description for the element to capture. Required when mode is 'element'. Examples: 'div.profile', '#submit-btn', 'the login form'"
                   },
                   scale: {
-                    type: "integer",
-                    description: "Scale percentage for the output image (1-100). Default is 100 (no scaling). Example: 50 will return an image at 50% of the original size (half width and height)."
+                    type: "string",
+                    description: "Scale percentage for the output image (1-100). Default is 100 (no scaling). Example: 50 will return an image at 50%% of the original size (half width and height)."
                   }
                 },
                 required: [
@@ -22552,11 +22573,11 @@ var openapi_default = {
                     description: "Starting URL to begin extraction from"
                   },
                   depth: {
-                    type: "integer",
+                    type: "string",
                     description: "How many link levels to follow from the starting page. Default: 2. Higher values extract more pages but take longer"
                   },
                   max_pages: {
-                    type: "integer",
+                    type: "string",
                     description: "Maximum number of pages to extract. Default: 5. Limits total extraction to prevent runaway crawling"
                   },
                   follow_external: {
@@ -22582,10 +22603,10 @@ var openapi_default = {
                   },
                   exclude_patterns: {
                     type: "string",
-                    description: `JSON array of URL patterns to skip (glob patterns). Example: '["*/login*", "*/admin/*"]'`
+                    description: 'Array of URL patterns to skip (glob patterns). Example: ["*/login*", "*/admin/*"]'
                   },
                   timeout_per_page: {
-                    type: "integer",
+                    type: "string",
                     description: "Timeout per page in milliseconds. Default: 10000 (10 seconds)"
                   }
                 },
@@ -22930,7 +22951,7 @@ var openapi_default = {
     "/api/execute/browser_llm_status": {
       post: {
         summary: "Browser Llm Status",
-        description: "Check if the on-device LLM is ready to use. Returns status: 'ready', 'loading', or 'unavailable'. Call this before using LLM-powered features to ensure the model is loaded.",
+        description: "Check if the LLM is ready to use. When context_id is provided, returns the LLM configuration and status for that specific context (which may use an external LLM provider like OpenAI). When context_id is omitted, returns the global built-in LLM status. Response includes: status ('ready', 'loading', 'unavailable'), type ('builtin', 'external', 'none'), and for external LLMs: endpoint and model name.",
         tags: [
           "General"
         ],
@@ -22940,7 +22961,12 @@ var openapi_default = {
             "application/json": {
               schema: {
                 type: "object",
-                properties: {}
+                properties: {
+                  context_id: {
+                    type: "string",
+                    description: "Optional browser context ID. When provided, returns LLM status for that specific context (which may use an external LLM endpoint). When omitted, returns global built-in LLM status."
+                  }
+                }
               }
             }
           }
@@ -23775,6 +23801,45 @@ var openapi_default = {
         }
       }
     },
+    "/api/execute/browser_reset_viewport": {
+      post: {
+        summary: "Browser Reset Viewport",
+        description: "Reset the browser viewport to its original default size (from the VM profile screen dimensions, typically 1920x1080). Use this to undo any viewport changes made by browser_set_viewport.",
+        tags: [
+          "General"
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  context_id: {
+                    type: "string",
+                    description: "The unique identifier of the browser context (e.g., 'ctx_000001')"
+                  }
+                },
+                required: [
+                  "context_id"
+                ]
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Successful response"
+          },
+          "400": {
+            description: "Bad request"
+          },
+          "401": {
+            description: "Unauthorized"
+          }
+        }
+      }
+    },
     "/api/execute/browser_zoom_in": {
       post: {
         summary: "Browser Zoom In",
@@ -24185,6 +24250,45 @@ var openapi_default = {
         }
       }
     },
+    "/api/execute/browser_download_video_recording": {
+      post: {
+        summary: "Browser Download Video Recording",
+        description: "Get a download URL for a completed video recording. Returns a temporary URL that can be used to download the recorded MP4 video file. The recording must be stopped first using browser_stop_video_recording.",
+        tags: [
+          "General"
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  context_id: {
+                    type: "string",
+                    description: "The unique identifier of the browser context (e.g., 'ctx_000001')"
+                  }
+                },
+                required: [
+                  "context_id"
+                ]
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Successful response"
+          },
+          "400": {
+            description: "Bad request"
+          },
+          "401": {
+            description: "Unauthorized"
+          }
+        }
+      }
+    },
     "/api/execute/browser_start_live_stream": {
       post: {
         summary: "Browser Start Live Stream",
@@ -24926,13 +25030,14 @@ var openapi_default = {
                   },
                   type: {
                     type: "string",
-                    description: "Proxy protocol type: 'http' (HTTP proxy), 'https' (HTTPS proxy), 'socks4' (SOCKS4), 'socks5' (SOCKS5 with local DNS), 'socks5h' (SOCKS5 with remote DNS - most private)",
+                    description: "Proxy protocol type: 'http' (HTTP proxy), 'https' (HTTPS proxy), 'socks4' (SOCKS4), 'socks5' (SOCKS5 with local DNS), 'socks5h' (SOCKS5 with remote DNS - most private), 'gae' (private app proxy)",
                     enum: [
                       "http",
                       "https",
                       "socks4",
                       "socks5",
-                      "socks5h"
+                      "socks5h",
+                      "gae"
                     ]
                   },
                   host: {
@@ -24974,6 +25079,30 @@ var openapi_default = {
                   language_override: {
                     type: "string",
                     description: "Manually set browser language instead of auto-detection. BCP47 format like 'en-US', 'de-DE'. Takes precedence over spoof_language"
+                  },
+                  ca_cert_path: {
+                    type: "string",
+                    description: "Path to custom CA certificate file (.pem, .crt, .cer) for SSL interception proxies. Required when using Charles Proxy, mitmproxy, or similar HTTPS inspection tools"
+                  },
+                  ca_key_path: {
+                    type: "string",
+                    description: "Path to CA private key file for GAE/private app proxy MITM. Required for generating per-domain certificates when using 'gae' proxy type"
+                  },
+                  trust_custom_ca: {
+                    type: "boolean",
+                    description: "Trust the custom CA certificate for SSL interception. Enable when using Charles Proxy, mitmproxy, or similar tools that intercept HTTPS traffic. Default: false"
+                  },
+                  is_tor: {
+                    type: "boolean",
+                    description: "Explicitly mark this proxy as a Tor connection. Enables circuit isolation so each context gets a unique exit node IP. Auto-detected if proxy is localhost:9050 or localhost:9150 with socks5/socks5h"
+                  },
+                  tor_control_port: {
+                    type: "string",
+                    description: "Tor control port for circuit isolation. Used to send SIGNAL NEWNYM to get a new exit node. Default: auto-detect (tries 9051 then 9151). Set to -1 to disable circuit isolation"
+                  },
+                  tor_control_password: {
+                    type: "string",
+                    description: "Password for Tor control port authentication. Leave empty to use cookie authentication (default) or no auth"
                   }
                 },
                 required: [
@@ -25116,6 +25245,50 @@ var openapi_default = {
         }
       }
     },
+    "/api/execute/browser_set_timezone": {
+      post: {
+        summary: "Browser Set Timezone",
+        description: "Set or override the timezone for an existing browser context at runtime. Useful for adjusting timezone after detecting proxy exit IP location. The timezone is immediately applied to all frames in the context.",
+        tags: [
+          "General"
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  context_id: {
+                    type: "string",
+                    description: "The unique identifier of the browser context (e.g., 'ctx_000001')"
+                  },
+                  timezone: {
+                    type: "string",
+                    description: "IANA timezone format (e.g., 'America/New_York', 'Europe/London', 'Asia/Tokyo'). This overrides any previously set timezone including VM profile defaults. Must contain '/' and be between 5-50 characters."
+                  }
+                },
+                required: [
+                  "context_id",
+                  "timezone"
+                ]
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Successful response"
+          },
+          "400": {
+            description: "Bad request"
+          },
+          "401": {
+            description: "Unauthorized"
+          }
+        }
+      }
+    },
     "/api/execute/browser_create_profile": {
       post: {
         summary: "Browser Create Profile",
@@ -25130,6 +25303,10 @@ var openapi_default = {
               schema: {
                 type: "object",
                 properties: {
+                  context_id: {
+                    type: "string",
+                    description: "Optional browser context ID. If provided, associates the created profile with this context. If omitted, creates a standalone profile that can be applied to any context later."
+                  },
                   name: {
                     type: "string",
                     description: "Human-readable name for the profile to help identify it. Examples: 'Shopping Account', 'Test User 1'. Optional but recommended for managing multiple profiles"
@@ -25172,7 +25349,7 @@ var openapi_default = {
                   },
                   profile_path: {
                     type: "string",
-                    description: "Absolute path to the profile JSON file to load. The file must exist and contain valid profile data. Example: '/home/user/profiles/shopping.json'"
+                    description: "Path to the profile .json file to load (or upload file via multipart/form-data). Accepts both raw JSON profiles and encrypted profiles from browser_download_profile. Encrypted content (base64) is automatically detected and decrypted based on content, not extension. Example: '/home/user/profiles/shopping.json'"
                   }
                 },
                 required: [
@@ -25199,7 +25376,7 @@ var openapi_default = {
     "/api/execute/browser_save_profile": {
       post: {
         summary: "Browser Save Profile",
-        description: "Save the current context state (fingerprints, cookies, settings) to a profile JSON file. Useful for persisting login sessions and browser identity for reuse.",
+        description: "Save the current context state (fingerprints, cookies, settings) to a profile file on the server. Takes a profile_name (not path) and returns the filename. Use browser_download_profile to retrieve the file.",
         tags: [
           "General"
         ],
@@ -25214,13 +25391,58 @@ var openapi_default = {
                     type: "string",
                     description: "The unique identifier of the browser context to save (e.g., 'ctx_000001')"
                   },
-                  profile_path: {
+                  profile_name: {
                     type: "string",
-                    description: "Absolute path where the profile JSON file will be saved. If the context was loaded from a profile, this can be omitted to save to the original path. Example: '/home/user/profiles/new_profile.json'"
+                    description: "Name for the saved profile file (without path). Example: 'shopping_account', 'test_user_1'. The .json extension will be added automatically. Returns the filename that can be used with browser_download_profile."
                   }
                 },
                 required: [
-                  "context_id"
+                  "context_id",
+                  "profile_name"
+                ]
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Successful response"
+          },
+          "400": {
+            description: "Bad request"
+          },
+          "401": {
+            description: "Unauthorized"
+          }
+        }
+      }
+    },
+    "/api/execute/browser_download_profile": {
+      post: {
+        summary: "Browser Download Profile",
+        description: "Download a saved profile file from the server. Takes the profile_name returned by browser_save_profile and returns the profile content as base64-encoded JSON. The same profile can be downloaded regardless of which context_id was used to save it.",
+        tags: [
+          "General"
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  context_id: {
+                    type: "string",
+                    description: "The unique identifier of the browser context (e.g., 'ctx_000001')"
+                  },
+                  profile_name: {
+                    type: "string",
+                    description: "Name of the profile file to download (as returned by browser_save_profile). Example: 'shopping_account.json'. The .json extension is optional and will be added if missing. Returns base64-encoded profile content."
+                  }
+                },
+                required: [
+                  "context_id",
+                  "profile_name"
                 ]
               }
             }
@@ -25445,12 +25667,17 @@ var openapi_default = {
               schema: {
                 type: "object",
                 properties: {
+                  context_id: {
+                    type: "string",
+                    description: "The unique identifier of the browser context (e.g., 'ctx_000001')"
+                  },
                   rule_id: {
                     type: "string",
                     description: "The unique identifier of the rule to remove, returned by browser_add_network_rule when the rule was created"
                   }
                 },
                 required: [
+                  "context_id",
                   "rule_id"
                 ]
               }
@@ -25553,6 +25780,45 @@ var openapi_default = {
         }
       }
     },
+    "/api/execute/browser_get_network_rules": {
+      post: {
+        summary: "Browser Get Network Rules",
+        description: "List all network interception rules for a context. Returns an array of rules with their id, url_pattern, action (block/allow/mock/redirect), is_regex flag, and additional settings like redirect_url or mock_body depending on the action type.",
+        tags: [
+          "General"
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  context_id: {
+                    type: "string",
+                    description: "The unique identifier of the browser context (e.g., 'ctx_000001')"
+                  }
+                },
+                required: [
+                  "context_id"
+                ]
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Successful response"
+          },
+          "400": {
+            description: "Bad request"
+          },
+          "401": {
+            description: "Unauthorized"
+          }
+        }
+      }
+    },
     "/api/execute/browser_clear_network_log": {
       post: {
         summary: "Browser Clear Network Log",
@@ -25636,6 +25902,84 @@ var openapi_default = {
         }
       }
     },
+    "/api/execute/browser_disable_network_interception": {
+      post: {
+        summary: "Browser Disable Network Interception",
+        description: "Disable network interception for a context. All network rules will be ignored and requests pass through normally. Equivalent to calling browser_enable_network_interception with enable=false.",
+        tags: [
+          "General"
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  context_id: {
+                    type: "string",
+                    description: "The unique identifier of the browser context (e.g., 'ctx_000001')"
+                  }
+                },
+                required: [
+                  "context_id"
+                ]
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Successful response"
+          },
+          "400": {
+            description: "Bad request"
+          },
+          "401": {
+            description: "Unauthorized"
+          }
+        }
+      }
+    },
+    "/api/execute/browser_disable_network_logging": {
+      post: {
+        summary: "Browser Disable Network Logging",
+        description: "Disable network request/response logging for a context. Network activity will no longer be captured. Equivalent to calling browser_enable_network_logging with enable=false.",
+        tags: [
+          "General"
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  context_id: {
+                    type: "string",
+                    description: "The unique identifier of the browser context (e.g., 'ctx_000001')"
+                  }
+                },
+                required: [
+                  "context_id"
+                ]
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Successful response"
+          },
+          "400": {
+            description: "Bad request"
+          },
+          "401": {
+            description: "Unauthorized"
+          }
+        }
+      }
+    },
     "/api/execute/browser_set_download_path": {
       post: {
         summary: "Browser Set Download Path",
@@ -26519,13 +26863,12 @@ var openapi_default = {
                 properties: {
                   license_path: {
                     type: "string",
-                    description: "Absolute path to the license file (.olic extension). Provide either this OR license_content, not both. Example: '/path/to/license.olic'"
-                  },
-                  license_content: {
-                    type: "string",
-                    description: "Base64-encoded license file content. Alternative to license_path for passing license data directly without writing to disk. Provide either this OR license_path, not both"
+                    description: "Absolute path to the license file (.olic extension). Example: '/path/to/license.olic'"
                   }
-                }
+                },
+                required: [
+                  "license_path"
+                ]
               }
             }
           }
@@ -26987,6 +27330,117 @@ var openapi_default = {
           }
         }
       }
+    },
+    "/api/execute/server_restart_browser": {
+      post: {
+        summary: "Server Restart Browser",
+        description: "Restart the browser process. This stops the current browser subprocess and starts a new one. Useful after updating configuration, adding/removing licenses, or recovering from browser errors. All active browser contexts will be terminated. Returns success/failure status.",
+        tags: [
+          "General"
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  force: {
+                    type: "boolean",
+                    description: "Force restart even if browser appears healthy. Default: false"
+                  }
+                }
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Successful response"
+          },
+          "400": {
+            description: "Bad request"
+          },
+          "401": {
+            description: "Unauthorized"
+          }
+        }
+      }
+    },
+    "/api/execute/server_read_logs": {
+      post: {
+        summary: "Server Read Logs",
+        description: "Read log entries from either the browser process or HTTP server. By default reads from browser logs which contain detailed IPC commands, rendering events, and page interactions. Use source='server' for HTTP server logs. Supports head (first N lines), tail (last N lines), or range (specific line range) modes. Can filter logs by level (DEBUG, INFO, WARN, ERROR) and by pattern matching (regex or substring).",
+        tags: [
+          "General"
+        ],
+        requestBody: {
+          required: true,
+          content: {
+            "application/json": {
+              schema: {
+                type: "object",
+                properties: {
+                  source: {
+                    type: "string",
+                    description: "Log source to read from: 'browser' (browser process logs with detailed IPC, rendering, and page events) or 'server' (HTTP server logs). Default: 'browser'",
+                    enum: [
+                      "browser",
+                      "server"
+                    ]
+                  },
+                  mode: {
+                    type: "string",
+                    description: "Read mode: 'head' (first N lines), 'tail' (last N lines), 'range' (specific line range). Default: 'tail'",
+                    enum: [
+                      "head",
+                      "tail",
+                      "range"
+                    ]
+                  },
+                  lines: {
+                    type: "string",
+                    description: "Number of lines to return for head/tail mode. Default: 100"
+                  },
+                  start_line: {
+                    type: "string",
+                    description: "Starting line number for range mode (1-indexed). Default: 1"
+                  },
+                  end_line: {
+                    type: "string",
+                    description: "Ending line number for range mode (1-indexed). Default: start_line + 100"
+                  },
+                  filter: {
+                    type: "string",
+                    description: "Filter pattern to match log lines. Supports regex or simple substring matching."
+                  },
+                  level: {
+                    type: "string",
+                    description: "Filter by log level: 'DEBUG', 'INFO', 'WARN', 'ERROR'. Only lines with this level are returned.",
+                    enum: [
+                      "DEBUG",
+                      "INFO",
+                      "WARN",
+                      "ERROR"
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
+        responses: {
+          "200": {
+            description: "Successful response"
+          },
+          "400": {
+            description: "Bad request"
+          },
+          "401": {
+            description: "Unauthorized"
+          }
+        }
+      }
     }
   }
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@olib-ai/owl-browser-mcp",
-  "version": "1.0.4",
-  "description": "MCP server for Owl Browser HTTP API - 144 browser automation tools with anti-detection",
+  "version": "2.0.0",
+  "description": "MCP server for Owl Browser HTTP API - 157 browser automation tools with anti-detection",
   "type": "module",
   "main": "dist/index.js",
   "bin": {