diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
new file mode 100644
index 00000000..d7a4c2d6
--- /dev/null
+++ b/.codex-plugin/plugin.json
@@ -0,0 +1,21 @@
+{
+  "name": "firecrawl-mcp-server",
+  "version": "0.1.0",
+  "description": "Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.",
+  "author": {
+    "name": "firecrawl",
+    "url": "https://github.com/firecrawl"
+  },
+  "homepage": "https://github.com/firecrawl/firecrawl-mcp-server",
+  "repository": "https://github.com/firecrawl/firecrawl-mcp-server",
+  "keywords": ["mcp", "codex", "web-scraping", "crawler", "firecrawl"],
+  "mcpServers": "./.mcp.json",
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Firecrawl MCP Server",
+    "shortDescription": "Official Firecrawl MCP Server - Adds powerful web scraping and search",
+    "longDescription": "Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.",
+    "category": "API",
+    "websiteURL": "https://github.com/firecrawl/firecrawl-mcp-server"
+  }
+}
diff --git a/.github/workflows/codex-plugin-scanner.yml b/.github/workflows/codex-plugin-scanner.yml
new file mode 100644
index 00000000..ccc76049
--- /dev/null
+++ b/.github/workflows/codex-plugin-scanner.yml
@@ -0,0 +1,22 @@
+name: Codex Plugin Quality Gate
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: codex-plugin-scanner-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  scan:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
+      - name: Codex plugin scanner
+        uses: hashgraph-online/hol-codex-plugin-scanner-action@b45d6b583afe05819b24edc8e6418c9ad2e1f1d0 # v1
diff --git a/.mcp.json b/.mcp.json
new file mode 100644
index 00000000..e61b75c0
--- /dev/null
+++ b/.mcp.json
@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "firecrawl": {
+      "command": "npx",
+      "args": ["firecrawl-mcp"]
+    }
+  }
+}
diff --git a/skills/firecrawl/SKILL.md b/skills/firecrawl/SKILL.md
new file mode 100644
index 00000000..bc3b26bb
--- /dev/null
+++ b/skills/firecrawl/SKILL.md
@@ -0,0 +1,12 @@
+---
+name: firecrawl
+description: Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
+---
+
+# Firecrawl MCP Server
+
+Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
+
+## When to use
+- When you need firecrawl capabilities in your Codex workflow
+- See https://github.com/firecrawl/firecrawl-mcp-server for full setup instructions