Skip to content

Commit dd4441d

Browse files
danbarrclaudeactions-user
authored
feat(playwright): document configuration environment variables (#1168)
* feat(playwright): document configuration environment variables Add the full set of PLAYWRIGHT_MCP_* environment variables documented in the upstream microsoft/playwright-mcp README to both the toolhive and official registry entries. Defaults are described in the description text rather than set at the registry level so the upstream app remains the source of truth. Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: Dan Barr <6922515+danbarr@users.noreply.github.com> * chore: update tool lists for MCP servers (server.json)\n\nUpdated servers:\n- playwright\n- playwright\n\nAutomatically updated using 'catalog update-tools' command.\n\nCo-authored-by: danbarr <danbarr@users.noreply.github.com> --------- Signed-off-by: Dan Barr <6922515+danbarr@users.noreply.github.com> Co-authored-by: Dan Barr <6922515+danbarr@users.noreply.github.com> Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: GitHub Action <action@github.com>
1 parent 1b69500 commit dd4441d

2 files changed

Lines changed: 350 additions & 2 deletions

File tree

‎registries/official/servers/playwright/server.json‎

Lines changed: 175 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
"io.github.stacklok": {
66
"mcr.microsoft.com/playwright/mcp:v0.0.70": {
77
"metadata": {
8-
"last_updated": "2026-04-01T02:01:57Z",
8+
"last_updated": "2026-04-27T16:41:18Z",
99
"stars": 28552
1010
},
1111
"overview": "## Playwright MCP Server\n\nThe playwright MCP server provides browser automation capabilities using Playwright. The server enables comprehensive browser automation supporting Chromium, Firefox, and WebKit, with full control over page interactions including clicks, typing, navigation, and screenshots. Additional capabilities include network request monitoring, console message capture for debugging, form filling, file uploads, and dialog handling for complete workflow automation.",
@@ -737,6 +737,180 @@
737737
"name": "io.github.stacklok/playwright",
738738
"packages": [
739739
{
740+
"environmentVariables": [
741+
{
742+
"description": "Comma-separated list of hosts this server is allowed to serve from. Defaults to the host the server is bound to. Pass '*' to disable the host check.",
743+
"name": "PLAYWRIGHT_MCP_ALLOWED_HOSTS"
744+
},
745+
{
746+
"description": "Semicolon-separated list of trusted origins to allow the browser to request. Default is to allow all.",
747+
"name": "PLAYWRIGHT_MCP_ALLOWED_ORIGINS"
748+
},
749+
{
750+
"description": "Allow access to files outside of the workspace roots, including unrestricted access to file:// URLs.",
751+
"name": "PLAYWRIGHT_MCP_ALLOW_UNRESTRICTED_FILE_ACCESS"
752+
},
753+
{
754+
"description": "Semicolon-separated list of origins to block the browser from requesting. Evaluated before the allowlist.",
755+
"name": "PLAYWRIGHT_MCP_BLOCKED_ORIGINS"
756+
},
757+
{
758+
"description": "Block service workers.",
759+
"name": "PLAYWRIGHT_MCP_BLOCK_SERVICE_WORKERS"
760+
},
761+
{
762+
"description": "Browser or chrome channel to use. Possible values: chrome, firefox, webkit, msedge.",
763+
"name": "PLAYWRIGHT_MCP_BROWSER"
764+
},
765+
{
766+
"description": "Comma-separated list of additional capabilities to enable. Possible values: vision, pdf, devtools.",
767+
"name": "PLAYWRIGHT_MCP_CAPS"
768+
},
769+
{
770+
"description": "CDP endpoint to connect to.",
771+
"name": "PLAYWRIGHT_MCP_CDP_ENDPOINT"
772+
},
773+
{
774+
"description": "CDP headers to send with the connect request. Multiple can be specified.",
775+
"name": "PLAYWRIGHT_MCP_CDP_HEADER"
776+
},
777+
{
778+
"description": "Timeout in milliseconds for connecting to the CDP endpoint. Defaults to 30000.",
779+
"name": "PLAYWRIGHT_MCP_CDP_TIMEOUT"
780+
},
781+
{
782+
"description": "Language to use for code generation. Possible values: typescript, none. Defaults to typescript.",
783+
"name": "PLAYWRIGHT_MCP_CODEGEN"
784+
},
785+
{
786+
"description": "Path to the configuration file.",
787+
"name": "PLAYWRIGHT_MCP_CONFIG"
788+
},
789+
{
790+
"description": "Level of console messages to return: error, warning, info, debug. Each level includes messages of more severe levels.",
791+
"name": "PLAYWRIGHT_MCP_CONSOLE_LEVEL"
792+
},
793+
{
794+
"description": "Device to emulate, for example 'iPhone 15'.",
795+
"name": "PLAYWRIGHT_MCP_DEVICE"
796+
},
797+
{
798+
"description": "Bound browser endpoint to connect to.",
799+
"name": "PLAYWRIGHT_MCP_ENDPOINT"
800+
},
801+
{
802+
"description": "Path to the browser executable.",
803+
"name": "PLAYWRIGHT_MCP_EXECUTABLE_PATH"
804+
},
805+
{
806+
"description": "Connect to a running browser instance (Edge/Chrome only). Requires the Playwright Extension to be installed.",
807+
"name": "PLAYWRIGHT_MCP_EXTENSION"
808+
},
809+
{
810+
"description": "List of permissions to grant to the browser context, for example 'geolocation', 'clipboard-read', 'clipboard-write'.",
811+
"name": "PLAYWRIGHT_MCP_GRANT_PERMISSIONS"
812+
},
813+
{
814+
"description": "Run browser in headless mode. Headed by default.",
815+
"name": "PLAYWRIGHT_MCP_HEADLESS"
816+
},
817+
{
818+
"description": "Host to bind the server to. Use 0.0.0.0 to bind to all interfaces. Defaults to localhost.",
819+
"name": "PLAYWRIGHT_MCP_HOST"
820+
},
821+
{
822+
"description": "Ignore HTTPS errors.",
823+
"name": "PLAYWRIGHT_MCP_IGNORE_HTTPS_ERRORS"
824+
},
825+
{
826+
"description": "Whether to send image responses to the client. Possible values: allow, omit. Defaults to allow.",
827+
"name": "PLAYWRIGHT_MCP_IMAGE_RESPONSES"
828+
},
829+
{
830+
"description": "Path to a TypeScript file to evaluate on the Playwright page object.",
831+
"name": "PLAYWRIGHT_MCP_INIT_PAGE"
832+
},
833+
{
834+
"description": "Path to a JavaScript file to add as an initialization script. Evaluated on every page before any of the page's scripts. Can be specified multiple times.",
835+
"name": "PLAYWRIGHT_MCP_INIT_SCRIPT"
836+
},
837+
{
838+
"description": "Keep the browser profile in memory; do not save it to disk.",
839+
"name": "PLAYWRIGHT_MCP_ISOLATED"
840+
},
841+
{
842+
"description": "Disable the sandbox for all process types that are normally sandboxed.",
843+
"name": "PLAYWRIGHT_MCP_NO_SANDBOX"
844+
},
845+
{
846+
"description": "Path to the directory for output files.",
847+
"name": "PLAYWRIGHT_MCP_OUTPUT_DIR"
848+
},
849+
{
850+
"description": "Whether to save snapshots, console messages, and network logs to a file or to standard output. Possible values: file, stdout. Defaults to stdout.",
851+
"name": "PLAYWRIGHT_MCP_OUTPUT_MODE"
852+
},
853+
{
854+
"description": "Port to listen on for SSE transport.",
855+
"name": "PLAYWRIGHT_MCP_PORT"
856+
},
857+
{
858+
"description": "Comma-separated domains to bypass the proxy, for example '.com,chromium.org,.domain.com'.",
859+
"name": "PLAYWRIGHT_MCP_PROXY_BYPASS"
860+
},
861+
{
862+
"description": "Proxy server, for example 'http://myproxy:3128' or 'socks5://myproxy:8080'.",
863+
"name": "PLAYWRIGHT_MCP_PROXY_SERVER"
864+
},
865+
{
866+
"description": "Enable the sandbox for all process types that are normally not sandboxed.",
867+
"name": "PLAYWRIGHT_MCP_SANDBOX"
868+
},
869+
{
870+
"description": "Whether to save the Playwright MCP session into the output directory.",
871+
"name": "PLAYWRIGHT_MCP_SAVE_SESSION"
872+
},
873+
{
874+
"description": "Path to a file containing secrets in the dotenv format.",
875+
"name": "PLAYWRIGHT_MCP_SECRETS"
876+
},
877+
{
878+
"description": "Reuse the same browser context between all connected HTTP clients.",
879+
"name": "PLAYWRIGHT_MCP_SHARED_BROWSER_CONTEXT"
880+
},
881+
{
882+
"description": "Mode to use when taking snapshots for responses. Possible values: full, none. Defaults to full.",
883+
"name": "PLAYWRIGHT_MCP_SNAPSHOT_MODE"
884+
},
885+
{
886+
"description": "Path to the storage state file for isolated sessions.",
887+
"name": "PLAYWRIGHT_MCP_STORAGE_STATE"
888+
},
889+
{
890+
"description": "Attribute to use for test ids. Defaults to data-testid.",
891+
"name": "PLAYWRIGHT_MCP_TEST_ID_ATTRIBUTE"
892+
},
893+
{
894+
"description": "Action timeout in milliseconds. Defaults to 5000.",
895+
"name": "PLAYWRIGHT_MCP_TIMEOUT_ACTION"
896+
},
897+
{
898+
"description": "Navigation timeout in milliseconds. Defaults to 60000.",
899+
"name": "PLAYWRIGHT_MCP_TIMEOUT_NAVIGATION"
900+
},
901+
{
902+
"description": "User agent string.",
903+
"name": "PLAYWRIGHT_MCP_USER_AGENT"
904+
},
905+
{
906+
"description": "Path to the user data directory. If not specified, a temporary directory will be created.",
907+
"name": "PLAYWRIGHT_MCP_USER_DATA_DIR"
908+
},
909+
{
910+
"description": "Browser viewport size in pixels, for example '1280x720'.",
911+
"name": "PLAYWRIGHT_MCP_VIEWPORT_SIZE"
912+
}
913+
],
740914
"identifier": "mcr.microsoft.com/playwright/mcp:v0.0.70",
741915
"registryType": "oci",
742916
"transport": {

‎registries/toolhive/servers/playwright/server.json‎

Lines changed: 175 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
"io.github.stacklok": {
66
"mcr.microsoft.com/playwright/mcp:v0.0.70": {
77
"metadata": {
8-
"last_updated": "2026-04-01T02:01:56Z",
8+
"last_updated": "2026-04-27T16:41:23Z",
99
"stars": 28552
1010
},
1111
"overview": "## Playwright MCP Server\n\nThe playwright MCP server provides browser automation capabilities using Playwright. The server enables comprehensive browser automation supporting Chromium, Firefox, and WebKit, with full control over page interactions including clicks, typing, navigation, and screenshots. Additional capabilities include network request monitoring, console message capture for debugging, form filling, file uploads, and dialog handling for complete workflow automation.",
@@ -737,6 +737,180 @@
737737
"name": "io.github.stacklok/playwright",
738738
"packages": [
739739
{
740+
"environmentVariables": [
741+
{
742+
"description": "Comma-separated list of hosts this server is allowed to serve from. Defaults to the host the server is bound to. Pass '*' to disable the host check.",
743+
"name": "PLAYWRIGHT_MCP_ALLOWED_HOSTS"
744+
},
745+
{
746+
"description": "Semicolon-separated list of trusted origins to allow the browser to request. Default is to allow all.",
747+
"name": "PLAYWRIGHT_MCP_ALLOWED_ORIGINS"
748+
},
749+
{
750+
"description": "Allow access to files outside of the workspace roots, including unrestricted access to file:// URLs.",
751+
"name": "PLAYWRIGHT_MCP_ALLOW_UNRESTRICTED_FILE_ACCESS"
752+
},
753+
{
754+
"description": "Semicolon-separated list of origins to block the browser from requesting. Evaluated before the allowlist.",
755+
"name": "PLAYWRIGHT_MCP_BLOCKED_ORIGINS"
756+
},
757+
{
758+
"description": "Block service workers.",
759+
"name": "PLAYWRIGHT_MCP_BLOCK_SERVICE_WORKERS"
760+
},
761+
{
762+
"description": "Browser or chrome channel to use. Possible values: chrome, firefox, webkit, msedge.",
763+
"name": "PLAYWRIGHT_MCP_BROWSER"
764+
},
765+
{
766+
"description": "Comma-separated list of additional capabilities to enable. Possible values: vision, pdf, devtools.",
767+
"name": "PLAYWRIGHT_MCP_CAPS"
768+
},
769+
{
770+
"description": "CDP endpoint to connect to.",
771+
"name": "PLAYWRIGHT_MCP_CDP_ENDPOINT"
772+
},
773+
{
774+
"description": "CDP headers to send with the connect request. Multiple can be specified.",
775+
"name": "PLAYWRIGHT_MCP_CDP_HEADER"
776+
},
777+
{
778+
"description": "Timeout in milliseconds for connecting to the CDP endpoint. Defaults to 30000.",
779+
"name": "PLAYWRIGHT_MCP_CDP_TIMEOUT"
780+
},
781+
{
782+
"description": "Language to use for code generation. Possible values: typescript, none. Defaults to typescript.",
783+
"name": "PLAYWRIGHT_MCP_CODEGEN"
784+
},
785+
{
786+
"description": "Path to the configuration file.",
787+
"name": "PLAYWRIGHT_MCP_CONFIG"
788+
},
789+
{
790+
"description": "Level of console messages to return: error, warning, info, debug. Each level includes messages of more severe levels.",
791+
"name": "PLAYWRIGHT_MCP_CONSOLE_LEVEL"
792+
},
793+
{
794+
"description": "Device to emulate, for example 'iPhone 15'.",
795+
"name": "PLAYWRIGHT_MCP_DEVICE"
796+
},
797+
{
798+
"description": "Bound browser endpoint to connect to.",
799+
"name": "PLAYWRIGHT_MCP_ENDPOINT"
800+
},
801+
{
802+
"description": "Path to the browser executable.",
803+
"name": "PLAYWRIGHT_MCP_EXECUTABLE_PATH"
804+
},
805+
{
806+
"description": "Connect to a running browser instance (Edge/Chrome only). Requires the Playwright Extension to be installed.",
807+
"name": "PLAYWRIGHT_MCP_EXTENSION"
808+
},
809+
{
810+
"description": "List of permissions to grant to the browser context, for example 'geolocation', 'clipboard-read', 'clipboard-write'.",
811+
"name": "PLAYWRIGHT_MCP_GRANT_PERMISSIONS"
812+
},
813+
{
814+
"description": "Run browser in headless mode. Headed by default.",
815+
"name": "PLAYWRIGHT_MCP_HEADLESS"
816+
},
817+
{
818+
"description": "Host to bind the server to. Use 0.0.0.0 to bind to all interfaces. Defaults to localhost.",
819+
"name": "PLAYWRIGHT_MCP_HOST"
820+
},
821+
{
822+
"description": "Ignore HTTPS errors.",
823+
"name": "PLAYWRIGHT_MCP_IGNORE_HTTPS_ERRORS"
824+
},
825+
{
826+
"description": "Whether to send image responses to the client. Possible values: allow, omit. Defaults to allow.",
827+
"name": "PLAYWRIGHT_MCP_IMAGE_RESPONSES"
828+
},
829+
{
830+
"description": "Path to a TypeScript file to evaluate on the Playwright page object.",
831+
"name": "PLAYWRIGHT_MCP_INIT_PAGE"
832+
},
833+
{
834+
"description": "Path to a JavaScript file to add as an initialization script. Evaluated on every page before any of the page's scripts. Can be specified multiple times.",
835+
"name": "PLAYWRIGHT_MCP_INIT_SCRIPT"
836+
},
837+
{
838+
"description": "Keep the browser profile in memory; do not save it to disk.",
839+
"name": "PLAYWRIGHT_MCP_ISOLATED"
840+
},
841+
{
842+
"description": "Disable the sandbox for all process types that are normally sandboxed.",
843+
"name": "PLAYWRIGHT_MCP_NO_SANDBOX"
844+
},
845+
{
846+
"description": "Path to the directory for output files.",
847+
"name": "PLAYWRIGHT_MCP_OUTPUT_DIR"
848+
},
849+
{
850+
"description": "Whether to save snapshots, console messages, and network logs to a file or to standard output. Possible values: file, stdout. Defaults to stdout.",
851+
"name": "PLAYWRIGHT_MCP_OUTPUT_MODE"
852+
},
853+
{
854+
"description": "Port to listen on for SSE transport.",
855+
"name": "PLAYWRIGHT_MCP_PORT"
856+
},
857+
{
858+
"description": "Comma-separated domains to bypass the proxy, for example '.com,chromium.org,.domain.com'.",
859+
"name": "PLAYWRIGHT_MCP_PROXY_BYPASS"
860+
},
861+
{
862+
"description": "Proxy server, for example 'http://myproxy:3128' or 'socks5://myproxy:8080'.",
863+
"name": "PLAYWRIGHT_MCP_PROXY_SERVER"
864+
},
865+
{
866+
"description": "Enable the sandbox for all process types that are normally not sandboxed.",
867+
"name": "PLAYWRIGHT_MCP_SANDBOX"
868+
},
869+
{
870+
"description": "Whether to save the Playwright MCP session into the output directory.",
871+
"name": "PLAYWRIGHT_MCP_SAVE_SESSION"
872+
},
873+
{
874+
"description": "Path to a file containing secrets in the dotenv format.",
875+
"name": "PLAYWRIGHT_MCP_SECRETS"
876+
},
877+
{
878+
"description": "Reuse the same browser context between all connected HTTP clients.",
879+
"name": "PLAYWRIGHT_MCP_SHARED_BROWSER_CONTEXT"
880+
},
881+
{
882+
"description": "Mode to use when taking snapshots for responses. Possible values: full, none. Defaults to full.",
883+
"name": "PLAYWRIGHT_MCP_SNAPSHOT_MODE"
884+
},
885+
{
886+
"description": "Path to the storage state file for isolated sessions.",
887+
"name": "PLAYWRIGHT_MCP_STORAGE_STATE"
888+
},
889+
{
890+
"description": "Attribute to use for test ids. Defaults to data-testid.",
891+
"name": "PLAYWRIGHT_MCP_TEST_ID_ATTRIBUTE"
892+
},
893+
{
894+
"description": "Action timeout in milliseconds. Defaults to 5000.",
895+
"name": "PLAYWRIGHT_MCP_TIMEOUT_ACTION"
896+
},
897+
{
898+
"description": "Navigation timeout in milliseconds. Defaults to 60000.",
899+
"name": "PLAYWRIGHT_MCP_TIMEOUT_NAVIGATION"
900+
},
901+
{
902+
"description": "User agent string.",
903+
"name": "PLAYWRIGHT_MCP_USER_AGENT"
904+
},
905+
{
906+
"description": "Path to the user data directory. If not specified, a temporary directory will be created.",
907+
"name": "PLAYWRIGHT_MCP_USER_DATA_DIR"
908+
},
909+
{
910+
"description": "Browser viewport size in pixels, for example '1280x720'.",
911+
"name": "PLAYWRIGHT_MCP_VIEWPORT_SIZE"
912+
}
913+
],
740914
"identifier": "mcr.microsoft.com/playwright/mcp:v0.0.70",
741915
"registryType": "oci",
742916
"transport": {

0 commit comments

Comments
 (0)