Document durable MCP tool contracts

[IlyaasK]

Summary

• document MCP browser-pool create/update validation and clear semantics
• document authoritative profile and extension IDs
• document exact profile setup, profile rename, and duplicate recovery
• document proxy retrieve, rename, and check actions

Why

The MCP reference lagged the merged durable API and the updated MCP tool surface. This makes the supported operations and destructive side effects explicit.

Verification

• Mint broken-links
• git diff --check
• documentation checked against the reviewed MCP implementation branches
• API limits and defaults checked against kernel/kernel merged origin/main

---

Note

Low Risk
Documentation-only changes with no runtime or API behavior impact.

Overview
Updates the MCP reference for manage_browser_pools, manage_profiles, and manage_proxies so it matches the merged durable API and tool surface.

Browser pools — Documents the update action and treats most create fields as updatable, including clear semantics (clear_profile, clear_extensions, empty proxy_id/start_url, empty chrome_policy). Adds extensions, viewport, kiosk_mode, discard_all_idle, and tighter notes on fill_rate_per_minute (default 25, 0 pauses) and timeout_seconds bounds. Notes that get/create/update responses expose authoritative profile_id and extension_ids.

Profiles — Adds get and rename, clarifies exact-name setup, duplicate recovery, and update_existing behavior, and warns against renaming while a browser session is using the profile.

Proxies — Adds get, rename, and check (with optional check_url).

^{Reviewed by Cursor Bugbot for commit b180f7a. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Kernel	🟢 Ready	View Preview	Aug 6, 2026, 10:07 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Error		Aug 6, 2026 10:06pm

[cursor]

Risk Assessment: Very Low

Verdict: Approve

Summary

Small documentation-only update to three MCP tool reference pages. No application code, infrastructure, auth, or runtime behavior changes.

Evidence

Factor	Assessment
Codepaths modified	Docs only: manage-browser-pools.mdx, manage-profiles.mdx, manage-proxies.mdx
Diff size	3 files, +40 / −17
Blast radius	Documentation site content only
Infra / security impact	None
Production logic	None

What changed

• Documents update and related clear/config parameters for browser pools
• Documents get / rename (and related notes) for profiles
• Documents get / rename / check for proxies

Decision

Fits Very Low criteria (documentation-only, small scoped diff, no shared systems or production logic). No CODEOWNERS requirement detected. No prior approval present.

Action taken: Approved.

  

_{Sent by Cursor Automation: Assign PR reviewers}