diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
new file mode 100644
index 0000000..461216a
--- /dev/null
+++ b/.codex-plugin/plugin.json
@@ -0,0 +1,15 @@
+{
+  "schema_version": "1.0",
+  "name": "mapbox-mcp-server",
+  "version": "1.0.0",
+  "registry": { "visibility": "public" },
+  "manifest": {
+    "homepage": "https://github.com/mapbox/mcp-server",
+    "repository": "https://github.com/mapbox/mcp-server",
+    "license": "BSD-2-Clause"
+  },
+  "tools": [
+    { "id": "mapbox_geocode", "name": "geocode", "description": "Geocode addresses to coordinates" },
+    { "id": "mapbox_directions", "name": "directions", "description": "Get driving/walking directions" }
+  ]
+}
\ No newline at end of file
diff --git a/.github/workflows/codex-plugin-scanner.yml b/.github/workflows/codex-plugin-scanner.yml
new file mode 100644
index 0000000..2504d16
--- /dev/null
+++ b/.github/workflows/codex-plugin-scanner.yml
@@ -0,0 +1,21 @@
+name: Codex Plugin Scanner
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - '.codex-plugin/**'
+      - '.mcp.json'
+  pull_request:
+    paths:
+      - '.codex-plugin/**'
+      - '.mcp.json'
+
+jobs:
+  scan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: hashgraph-online/codex-plugin-scanner@v1
+        with:
+          mode: validate
\ No newline at end of file
diff --git a/.mcp.json b/.mcp.json
new file mode 100644
index 0000000..8b7de61
--- /dev/null
+++ b/.mcp.json
@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "mapbox-mcp-server": {
+      "command": "npx",
+      "args": ["-y", "@mapbox/mcp-server"]
+    }
+  }
+}
\ No newline at end of file