diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json
new file mode 100644
index 0000000..3f8a95f
--- /dev/null
+++ b/.cursor-plugin/plugin.json
@@ -0,0 +1,29 @@
+{
+  "name": "parseable",
+  "displayName": "Parseable",
+  "version": "0.2.14",
+  "description": "Query and manage Parseable logs, metrics, datasets, and alerts from Cursor.",
+  "author": {
+    "name": "Parseable"
+  },
+  "publisher": "Parseable",
+  "homepage": "https://www.parseable.com",
+  "repository": "https://github.com/parseablehq/parseable-mcp-server",
+  "license": "Apache-2.0",
+  "logo": "assets/logo.svg",
+  "keywords": [
+    "parseable",
+    "observability",
+    "logs",
+    "metrics",
+    "alerts",
+    "mcp"
+  ],
+  "category": "developer-tools",
+  "tags": [
+    "observability",
+    "monitoring",
+    "mcp"
+  ],
+  "mcpServers": "./mcp.json"
+}
diff --git a/README.md b/README.md
index 7494002..8764ea7 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,35 @@ npx -y @parseable/parseable-mcp-server init \
 
 Supported `--client` values: `claude-desktop`, `cursor`.
 
+### Cursor Marketplace plugin
+
+The repository also contains a native Cursor plugin manifest. Marketplace installs connect to `https://mcp.parseable.com/mcp` and read credentials from the environment.
+
+Set these variables before starting Cursor:
+
+```bash
+export PARSEABLE_URL="https://your-parseable.example.com"
+export PARSEABLE_API_KEY="your-api-key"
+export PARSEABLE_MODE="self-hosted"
+```
+
+`PARSEABLE_API_KEY` and `PARSEABLE_MODE` are required by the Cursor plugin. Use `PARSEABLE_MODE=cloud` and omit `PARSEABLE_URL` for Parseable Cloud. Use `PARSEABLE_MODE=self-hosted` with `PARSEABLE_URL` for self-hosted Parseable.
+
+```bash
+# Parseable Cloud
+export PARSEABLE_MODE="cloud"
+export PARSEABLE_API_KEY="your-cloud-api-key"
+unset PARSEABLE_URL
+```
+
+Then install the Parseable plugin from the Cursor Marketplace. If Cursor was opened from the macOS dock or another GUI launcher that does not inherit shell variables, use the interactive setup instead:
+
+```bash
+npx -y @parseable/parseable-mcp-server init --client cursor
+```
+
+Plugin metadata lives in `.cursor-plugin/plugin.json`; its MCP connection configuration lives in `mcp.json`. Keep the plugin version aligned with the npm package version when releasing.
+
 ---
 
 ## Quickstart — HTTP (hosted)
diff --git a/assets/logo.svg b/assets/logo.svg
new file mode 100644
index 0000000..981da88
--- /dev/null
+++ b/assets/logo.svg
@@ -0,0 +1,7 @@
+<svg width="512" height="512" viewBox="0 0 512 512" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M382.773 157.268C397.535 142.483 421.487 142.465 436.272 157.227C451.056 171.989 451.074 195.941 436.313 210.725L209.118 438.268C194.356 453.052 170.404 453.07 155.619 438.308C140.835 423.547 140.816 399.594 155.578 384.81L382.773 157.268Z" fill="#17181C"/>
+<path d="M252.088 66.3252C260.324 58.1127 253.929 43.9364 242.382 44.8067C193.082 48.4586 144.758 69.1201 106.893 106.879C69.0268 144.638 48.0602 193.072 43.9897 242.641C43.0212 254.296 57.0531 260.856 65.289 252.598L252.088 66.3252Z" fill="#17181C"/>
+<path d="M445.222 259.741C453.472 251.543 467.744 257.877 466.886 269.356C463.287 318.365 442.574 366.428 404.644 404.123C366.714 441.818 318.018 462.733 268.155 466.854C256.431 467.835 249.809 453.897 258.105 445.699L445.222 259.741Z" fill="#17181C"/>
+<path d="M193.421 287.684L355.277 126.213C373.428 107.827 367.604 77.2794 343.884 66.6349L343.225 66.3675C328.748 59.8827 311.691 63.0294 300.607 74.303L138.937 235.588C124.295 250.418 124.633 274.077 139.692 288.488C154.75 302.899 178.781 302.56 193.422 287.73L193.421 287.684Z" fill="#17181C"/>
+<path d="M135.028 330.482C135.028 350.426 118.477 366.593 98.0599 366.593C77.643 366.593 61.0918 350.426 61.0918 330.482C61.0918 310.538 77.643 294.37 98.0599 294.37C118.477 294.37 135.028 310.538 135.028 330.482Z" fill="#17181C"/>
+</svg>
diff --git a/mcp.json b/mcp.json
new file mode 100644
index 0000000..aa0809c
--- /dev/null
+++ b/mcp.json
@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "parseable": {
+      "type": "http",
+      "url": "https://mcp.parseable.com/mcp",
+      "headers": {
+        "X-API-Key": "${env:PARSEABLE_API_KEY}",
+        "X-Parseable-Mode": "${env:PARSEABLE_MODE}",
+        "X-Parseable-URL": "${env:PARSEABLE_URL}"
+      }
+    }
+  }
+}
diff --git a/test/auth.test.ts b/test/auth.test.ts
index 21a6be8..deb6820 100644
--- a/test/auth.test.ts
+++ b/test/auth.test.ts
@@ -107,6 +107,12 @@ describe("parseRequestAuth", () => {
     );
   });
 
+  it("requires URL when self-hosted mode is explicit", () => {
+    expect(() =>
+      parseRequestAuth({ "x-parseable-mode": "self-hosted", "x-api-key": "secret" }),
+    ).toThrow(/X-Parseable-URL/);
+  });
+
   it("rejects unknown mode", () => {
     expect(() => parseRequestAuth({ ...goodHeaders, "x-parseable-mode": "enterprise" })).toThrow(
       /cloud or self-hosted/,