diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
new file mode 100644
index 0000000..d172b08
--- /dev/null
+++ b/.codex-plugin/plugin.json
@@ -0,0 +1,24 @@
+{
+  "name": "browserbase-mcp",
+  "version": "0.1.0",
+  "description": "Browser automation with Browserbase and Stagehand from Codex via MCP",
+  "author": {
+    "name": "browserbase",
+    "url": "https://github.com/browserbase/mcp-server-browserbase"
+  },
+  "homepage": "https://github.com/browserbase/mcp-server-browserbase",
+  "repository": "https://github.com/browserbase/mcp-server-browserbase",
+  "keywords": [
+    "mcp",
+    "codex"
+  ],
+  "mcpServers": "./.mcp.json",
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Browserbase MCP",
+    "shortDescription": "Browser automation with Browserbase and Stagehand from Codex via MCP",
+    "longDescription": "Allow LLMs to control a browser with Browserbase and Stagehand.",
+    "category": "Browser",
+    "websiteURL": "https://github.com/browserbase/mcp-server-browserbase"
+  }
+}
\ No newline at end of file
diff --git a/.github/workflows/plugin-quality-gate.yml b/.github/workflows/plugin-quality-gate.yml
new file mode 100644
index 0000000..c60a724
--- /dev/null
+++ b/.github/workflows/plugin-quality-gate.yml
@@ -0,0 +1,20 @@
+name: Plugin Quality Gate
+
+on:
+  pull_request:
+    paths:
+      - ".codex-plugin/**"
+      - "skills/**"
+      - ".mcp.json"
+
+jobs:
+  scan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Codex plugin quality gate
+        uses: hashgraph-online/hol-codex-plugin-scanner-action@v1
+        with:
+          plugin_dir: "."
+          min_score: 80
+          fail_on_severity: high
diff --git a/.mcp.json b/.mcp.json
new file mode 100644
index 0000000..ae240a4
--- /dev/null
+++ b/.mcp.json
@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "browserbase": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@browserbasehq/mcp"
+      ]
+    }
+  }
+}
\ No newline at end of file
diff --git a/skills/browserbase-mcp/SKILL.md b/skills/browserbase-mcp/SKILL.md
new file mode 100644
index 0000000..6fd887f
--- /dev/null
+++ b/skills/browserbase-mcp/SKILL.md
@@ -0,0 +1,12 @@
+---
+name: browserbase-mcp
+description: Browser automation with Browserbase and Stagehand from Codex via MCP
+---
+
+# Browserbase MCP for Codex
+
+Use Browserbase MCP from Codex via MCP.
+
+## When to use
+- When you need browserbase-mcp capabilities in your Codex workflow
+- See https://github.com/browserbase/mcp-server-browserbase for full setup instructions