Configuration

These tools control session-level configuration, privacy settings, and connection health diagnostics.

firefox_set_config

Set per-session configuration for this agent. Currently supports domain allowlisting to restrict navigation to specific domains (security sandboxing).

Parameters

Parameter	Type	Required	Default	Description
allowedDomains	string[]	No	-	List of allowed domains. Supports wildcards: "*.example.com". When set, firefox_navigate and firefox_create_window block requests to unlisted domains. Pass an empty array to clear the restriction.
timeout	number	No	150000	Request timeout in ms (5000-300000)

Example

// Restrict to a single domain
const result = await firefox_set_config({
  allowedDomains: ["example.com"]
});

// Allow a domain and all subdomains
const result = await firefox_set_config({
  allowedDomains: ["example.com", "*.example.com"]
});

// Clear domain restrictions
const result = await firefox_set_config({
  allowedDomains: []
});

Notes

• Domain restrictions apply only to the current agent session. Other agents are unaffected.
• Restrictions apply to both firefox_navigate and firefox_create_window.
• Use this for security sandboxing when you want to prevent accidental navigation to unintended sites.

---

firefox_set_private_mode

Enable or disable private (incognito) browsing mode. When disabled, new windows use regular browsing with persistent cookies.

Parameters

Parameter	Type	Required	Default	Description
enabled	boolean	Yes	-	true = private/incognito windows (default behavior), false = regular windows with persistent cookies
timeout	number	No	150000	Request timeout in ms (5000-300000)

Example

// Disable private mode to access sites requiring login
const result = await firefox_set_private_mode({ enabled: false });

// Navigate to a site that needs cookies
await firefox_create_window({ url: "https://x.com" });

// Re-enable private mode when done
await firefox_set_private_mode({ enabled: true });

Notes

• Private mode is enabled by default.
• Disable private mode when you need to access sites that require login or persistent cookies (e.g., X.com, authenticated dashboards).
• This setting affects new windows only. Existing windows retain their original mode.

---

firefox_diagnose

Diagnose Claudezilla connection health. Checks socket file, auth token, connection status, and extension version. Use this when troubleshooting connection issues.

Parameters

This tool takes no parameters. It runs locally on the MCP server without communicating through the extension.

Example

const result = await firefox_diagnose();
// Returns diagnostics including:
// - Socket file existence and permissions
// - Auth token status
// - Connection state
// - Extension version

Notes

• This tool runs locally and does not go through the Firefox extension. It works even when the extension connection is broken.
• Does not accept the timeout parameter (unlike all other tools).
• Use this as a first step when any other Claudezilla tool returns connection errors.