{"id":"roxybrowserlabs-roxybrowser-mcp-server","name":"roxybrowser-mcp-server","homepage":null,"repo_url":"https://github.com/roxybrowserlabs/roxybrowser-mcp-server","category":"ai-ml","subcategories":[],"tags":["mcp","browser-automation","cdp","roxybrowser","playwright","proxy-management","workspace-management","typescript"],"what_it_does":"An MCP server that integrates with RoxyBrowser to manage browser instances and return Chrome DevTools Protocol (CDP) WebSocket endpoints for automation. It exposes MCP tools for workspace/browser/proxy/account management and health checks, and can be run via CLI, in-process (stdio), or used as a library for direct tool handler calls.","use_cases":["Automate browser lifecycle (create/open/close/delete) for RoxyBrowser instances","Retrieve CDP WebSocket endpoints to drive browser automation via CDP-based tools","Build agent workflows that manage workspaces, proxies, and accounts before launching automation","Provide an MCP-compatible integration path for AI assistants to control RoxyBrowser","Run connectivity diagnostics via a health check tool"],"not_for":["Use as a standalone browser automation engine (it delegates to RoxyBrowser and other tools like Playwright MCP for actual page interactions)","Environments that cannot securely store and supply an API key to the MCP server","Use cases requiring documented REST/OpenAPI endpoints for this MCP server itself (the README references an OpenAPI package but does not provide an OpenAPI URL/spec in this repo content)"],"best_when":"You already run RoxyBrowser with its API enabled and want an MCP tool layer to create/open browsers, optionally configure proxies/accounts, and obtain CDP endpoints for downstream automation.","avoid_when":"You need strong guarantees about idempotent operations, retry safety, or detailed rate-limit/error-code specifications for agent orchestration (these are only partially described).","alternatives":["Use RoxyBrowser APIs directly (if available) without MCP","Use the RoxyBrowser Playwright MCP directly if you only need automation after browser startup","Other MCP/browser automation servers that provide CDP endpoints (if compatible with your agent runtime)"],"af_score":60.0,"security_score":51.0,"reliability_score":32.5,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:27:34.042736+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":true,"sdk_languages":["TypeScript","JavaScript"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["API key via ROXY_API_KEY / --api-key"],"oauth":false,"scopes":false,"notes":"Authentication is provided as a single API key passed to the MCP server environment/CLI; the README does not describe OAuth flows or fine-grained scopes."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"RoxyBrowser itself likely has pricing (e.g., profile quota), but package pricing/tiers are not described in the provided README/manifest."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":60.0,"security_score":51.0,"reliability_score":32.5,"mcp_server_quality":80.0,"documentation_accuracy":75.0,"error_message_quality":null,"error_message_notes":"Mentions example errors and handling tips (connection issues, auth config error, quota limits) but lacks structured per-tool error contract in the provided content.","auth_complexity":70.0,"rate_limit_clarity":10.0,"tls_enforcement":60.0,"auth_strength":65.0,"scope_granularity":20.0,"dependency_hygiene":45.0,"secret_handling":60.0,"security_notes":"Uses an API key supplied via CLI/env vars and targets a local API host by default. No scope granularity or rotation guidance is provided. README does not state whether TLS is enforced on the upstream RoxyBrowser API host; examples use http://127.0.0.1:50000. No dependency vulnerability status is provided in the manifest beyond basic dependencies.","uptime_documented":10.0,"version_stability":45.0,"breaking_changes_history":40.0,"error_recovery":35.0,"idempotency_support":"false","idempotency_notes":"No explicit idempotency guarantees are documented. Tools like delete/create/open/close can have side effects; quota/freeing behavior is described for close vs delete.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Config is read at process start and cannot be changed at runtime (env/config timing matters for agents).","Closing browsers does NOT free quota; only deletion does.","Correct dirIds/workspace IDs are required; agents should use list tools and health checks before opening."]}}