@rui.branco/sentry-mcp 1.0.2 → 1.0.4

package/README.md

@@ -1,6 +1,6 @@
 # Sentry MCP Server
 
-A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that brings Sentry error tracking context directly into Claude Code. Fetch issues, inspect stack traces, manage issue status, and search errors without leaving your development environment.
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that brings Sentry error tracking context directly into any MCP-compatible AI client — Claude Code, Codex CLI, Google's Antigravity (Gemini), Cursor, Windsurf, Zed, and others. Fetch issues, inspect stack traces, manage issue status, and search errors without leaving your development environment.
 
 ## Overview
 
@@ -8,7 +8,7 @@ When debugging production errors, context switching between Sentry and your code
 
 - **Fetching full issue details** - Get error metadata, event counts, assignment, and status instantly
 - **Inspecting stack traces** - View full stack traces with in-app frame markers, breadcrumbs, and HTTP request context
-- **Managing issues** - Resolve, reopen, ignore, and assign issues directly from Claude Code
+- **Managing issues** - Resolve, reopen, ignore, and assign issues directly from your AI client
 - **Searching errors** - Use Sentry's search syntax to find issues across your project
 
 ## Features
@@ -28,15 +28,39 @@ When debugging production errors, context switching between Sentry and your code
 ### Prerequisites
 
 - Node.js 18+
-- [Claude Code](https://claude.ai/code) CLI
+- An MCP-compatible AI client (see [Step 1](#step-1-register-with-your-mcp-client) below)
 - Sentry account with API access
 
-### Step 1: Add to Claude Code
+### Step 1: Register with your MCP client
+
+Pick the snippet for your client. All of them launch the server over stdio.
+
+**Claude Code:**
 
 ```bash
 claude mcp add --transport stdio sentry -- npx -y @rui.branco/sentry-mcp
 ```
 
+**Codex CLI:** add to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.sentry]
+command = "npx"
+args = ["-y", "@rui.branco/sentry-mcp"]
+```
+
+**Google Antigravity / Gemini CLI:** add to `~/.gemini/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "sentry": { "command": "npx", "args": ["-y", "@rui.branco/sentry-mcp"] }
+  }
+}
+```
+
+**Cursor, Windsurf, Zed, Cline, Continue, etc.:** add the same `command`/`args` pair to whatever JSON config that client uses for MCP servers (the exact path varies, but the shape is standard across clients).
+
 ### Step 2: Get Your Sentry API Token
 
 1. Go to [Sentry Auth Tokens](https://sentry.io/settings/account/api/auth-tokens/) (or your self-hosted Sentry equivalent)
@@ -68,7 +92,7 @@ npx @rui.branco/sentry-mcp setup
 
 ### Step 4: Verify
 
-Restart Claude Code and run `/mcp` to verify the server is connected.
+Restart your AI client and check its MCP status (e.g. `/mcp` in Claude Code, `mcp` in Codex CLI, or the equivalent panel in your client) to verify the server is connected.
 
 ### Alternative: Manual Installation
 
@@ -80,7 +104,7 @@ cd ~/.config/sentry-mcp && npm install
 node setup.js
 ```
 
-Then add to Claude Code:
+Then register the local entry point with your MCP client (replace the `npx -y @rui.branco/sentry-mcp` command from Step 1 with `node $HOME/.config/sentry-mcp/index.js`). Example for Claude Code:
 
 ```bash
 claude mcp add --transport stdio sentry -- node $HOME/.config/sentry-mcp/index.js
@@ -214,6 +238,6 @@ MIT
 
 ## Related
 
-- [jira-mcp](https://github.com/rui-branco/jira-mcp) - Jira MCP server for Claude Code
-- [figma-mcp](https://github.com/rui-branco/figma-mcp) - Figma MCP server for Claude Code
+- [jira-mcp](https://github.com/rui-branco/jira-mcp) - Jira MCP server (works with any MCP-compatible AI client)
+- [figma-mcp](https://github.com/rui-branco/figma-mcp) - Figma MCP server (works with any MCP-compatible AI client)
 - [Model Context Protocol](https://modelcontextprotocol.io/) - MCP specification

package/index.js

@@ -3,7 +3,7 @@
 // Handle setup command
 if (process.argv[2] === "setup") {
   require("./setup.js");
-  return;
+  process.exit(0);
 }
 
 const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
@@ -383,6 +383,232 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ["issueId", "assignee"],
         },
       },
+      {
+        name: "sentry_list_releases",
+        description:
+          "List releases for a Sentry project. Returns release versions, dates, and artifact counts.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description:
+                "Optional search query to filter releases by version (e.g. '26.05').",
+            },
+            instance: {
+              type: "string",
+              description:
+                "Instance name (for multi-instance setups). Uses default instance if omitted.",
+            },
+          },
+          required: [],
+        },
+      },
+      {
+        name: "sentry_get_release_artifacts",
+        description:
+          "List artifacts (source maps, JS bundles) uploaded for a specific release. Use to verify source maps were uploaded correctly.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string (e.g. '26.05.4b185-TRAIN').",
+            },
+            instance: {
+              type: "string",
+              description:
+                "Instance name (for multi-instance setups). Uses default instance if omitted.",
+            },
+          },
+          required: ["version"],
+        },
+      },
+      {
+        name: "sentry_create_release",
+        description:
+          "Create a new release in Sentry. Optionally associate commits and set a ref.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string (e.g. '1.0.0', '26.05.4b185-TRAIN').",
+            },
+            ref: {
+              type: "string",
+              description: "Optional git ref (commit SHA or tag).",
+            },
+            projects: {
+              type: "array",
+              items: { type: "string" },
+              description: "Project slugs to associate with this release. Defaults to the instance's projectSlug.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version"],
+        },
+      },
+      {
+        name: "sentry_finalize_release",
+        description:
+          "Finalize a release (mark it as deployed/complete). Sets dateReleased to now.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version"],
+        },
+      },
+      {
+        name: "sentry_delete_release",
+        description:
+          "Delete a release and all its artifacts from Sentry.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string to delete.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version"],
+        },
+      },
+      {
+        name: "sentry_create_deploy",
+        description:
+          "Create a deploy for a release. Records when and where a release was deployed.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string.",
+            },
+            environment: {
+              type: "string",
+              description: "Environment name (e.g. 'production', 'staging', 'QA', 'TRAIN').",
+            },
+            name: {
+              type: "string",
+              description: "Optional deploy name.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version", "environment"],
+        },
+      },
+      {
+        name: "sentry_list_deploys",
+        description:
+          "List deploys for a release.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version"],
+        },
+      },
+      {
+        name: "sentry_delete_artifact",
+        description:
+          "Delete a specific artifact from a release by its ID.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string.",
+            },
+            artifactId: {
+              type: "string",
+              description: "Artifact ID to delete (from sentry_get_release_artifacts).",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version", "artifactId"],
+        },
+      },
+      {
+        name: "sentry_set_commits",
+        description:
+          "Associate commits with a release. Provide a repository and commit range.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string.",
+            },
+            repository: {
+              type: "string",
+              description: "Repository name (e.g. 'org/repo').",
+            },
+            commit: {
+              type: "string",
+              description: "Current commit SHA (HEAD of the release).",
+            },
+            previousCommit: {
+              type: "string",
+              description: "Previous commit SHA (start of range). If omitted, uses the previous release's commit.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version", "repository", "commit"],
+        },
+      },
+      {
+        name: "sentry_get_release",
+        description:
+          "Get full details for a specific release including projects, commits, authors, and deploy info.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            version: {
+              type: "string",
+              description: "Release version string.",
+            },
+            instance: {
+              type: "string",
+              description: "Instance name. Uses default if omitted.",
+            },
+          },
+          required: ["version"],
+        },
+      },
       {
         name: "sentry_list_instances",
         description:
@@ -610,6 +836,183 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         ],
       };
 
+    } else if (name === "sentry_list_releases") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      if (!inst.projectSlug) throw new Error("No projectSlug configured for this instance.");
+      const params = new URLSearchParams();
+      if (args.query) params.set("query", args.query);
+      const data = await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/?project=${encodeURIComponent(inst.projectSlug)}&${params}`,
+        inst,
+      );
+      if (!data || !data.length) {
+        return {
+          content: [{ type: "text", text: `No releases found.${args.query ? ` Query: ${args.query}` : ""}` }],
+        };
+      }
+      const lines = data.slice(0, 25).map((r) => {
+        const artifacts = r.newGroups != null ? ` | New issues: ${r.newGroups}` : "";
+        return `- **${r.version}** | Created: ${r.dateCreated || "N/A"}${artifacts}${r.lastEvent ? ` | Last event: ${r.lastEvent}` : ""}`;
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Found ${data.length} release(s):\n\n${lines.join("\n")}`,
+          },
+        ],
+      };
+
+    } else if (name === "sentry_get_release_artifacts") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      const data = await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/files/`,
+        inst,
+      );
+      if (!data || !data.length) {
+        return {
+          content: [{ type: "text", text: `No artifacts found for release "${args.version}". Source maps may not have been uploaded.` }],
+        };
+      }
+      const lines = data.map((a) => {
+        const size = a.size ? ` (${(a.size / 1024).toFixed(1)} KB)` : "";
+        return `- ${a.name}${size} [id: ${a.id}]`;
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Found ${data.length} artifact(s) for release "${args.version}":\n\n${lines.join("\n")}`,
+          },
+        ],
+      };
+
+    } else if (name === "sentry_create_release") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      const projects = args.projects || (inst.projectSlug ? [inst.projectSlug] : []);
+      if (!projects.length) throw new Error("No projects specified and no projectSlug configured.");
+      const body = { version: args.version, projects };
+      if (args.ref) body.ref = args.ref;
+      const data = await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/`,
+        inst,
+        { method: "POST", body },
+      );
+      return {
+        content: [{ type: "text", text: `Release "${data.version}" created for projects: ${projects.join(", ")}` }],
+      };
+
+    } else if (name === "sentry_finalize_release") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/`,
+        inst,
+        { method: "PUT", body: { dateReleased: new Date().toISOString() } },
+      );
+      return {
+        content: [{ type: "text", text: `Release "${args.version}" finalized.` }],
+      };
+
+    } else if (name === "sentry_delete_release") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/`,
+        inst,
+        { method: "DELETE" },
+      );
+      return {
+        content: [{ type: "text", text: `Release "${args.version}" deleted.` }],
+      };
+
+    } else if (name === "sentry_create_deploy") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      const body = { environment: args.environment };
+      if (args.name) body.name = args.name;
+      const data = await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/deploys/`,
+        inst,
+        { method: "POST", body },
+      );
+      return {
+        content: [{ type: "text", text: `Deploy created for release "${args.version}" to environment "${args.environment}".` }],
+      };
+
+    } else if (name === "sentry_list_deploys") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      const data = await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/deploys/`,
+        inst,
+      );
+      if (!data || !data.length) {
+        return {
+          content: [{ type: "text", text: `No deploys found for release "${args.version}".` }],
+        };
+      }
+      const lines = data.map((d) => `- **${d.environment}** | ${d.dateFinished || d.dateStarted || "N/A"}${d.name ? ` | ${d.name}` : ""}`);
+      return {
+        content: [{ type: "text", text: `${data.length} deploy(s) for "${args.version}":\n\n${lines.join("\n")}` }],
+      };
+
+    } else if (name === "sentry_delete_artifact") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/files/${encodeURIComponent(args.artifactId)}/`,
+        inst,
+        { method: "DELETE" },
+      );
+      return {
+        content: [{ type: "text", text: `Artifact ${args.artifactId} deleted from release "${args.version}".` }],
+      };
+
+    } else if (name === "sentry_set_commits") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      const commitSpec = { repository: args.repository, currentId: args.commit };
+      if (args.previousCommit) commitSpec.previousId = args.previousCommit;
+      await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/commits/`,
+        inst,
+        { method: "PUT", body: { commits: [commitSpec] } },
+      );
+      return {
+        content: [{ type: "text", text: `Commits associated with release "${args.version}" (repo: ${args.repository}, HEAD: ${args.commit}).` }],
+      };
+
+    } else if (name === "sentry_get_release") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      const data = await fetchSentry(
+        `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/releases/${encodeURIComponent(args.version)}/`,
+        inst,
+      );
+      const lines = [];
+      lines.push(`**${data.version}**`);
+      lines.push(`- Status: ${data.status || "open"}`);
+      lines.push(`- Created: ${data.dateCreated || "N/A"}`);
+      if (data.dateReleased) lines.push(`- Released: ${data.dateReleased}`);
+      if (data.firstEvent) lines.push(`- First event: ${data.firstEvent}`);
+      if (data.lastEvent) lines.push(`- Last event: ${data.lastEvent}`);
+      lines.push(`- New issues: ${data.newGroups || 0}`);
+      lines.push(`- Commits: ${data.commitCount || 0}`);
+      lines.push(`- Deploys: ${data.deployCount || 0}`);
+      if (data.projects?.length) {
+        lines.push(`- Projects: ${data.projects.map((p) => p.slug || p.name).join(", ")}`);
+      }
+      if (data.authors?.length) {
+        lines.push(`- Authors: ${data.authors.map((a) => a.name || a.email).join(", ")}`);
+      }
+      return {
+        content: [{ type: "text", text: lines.join("\n") }],
+      };
+
     } else if (name === "sentry_list_instances") {
       if (!instances.length) {
         return {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rui.branco/sentry-mcp",
-  "version": "1.0.2",
-  "description": "Sentry MCP server for Claude Code - fetch issues, search errors, resolve/ignore issues, get stack traces and breadcrumbs",
+  "version": "1.0.4",
+  "description": "Sentry MCP server for any MCP-compatible AI client (Claude Code, Codex, Antigravity, Cursor, etc.) - fetch issues, search errors, resolve/ignore issues, get stack traces and breadcrumbs",
   "main": "index.js",
   "bin": {
     "sentry-mcp": "./index.js"
@@ -12,7 +12,8 @@
     "README.md"
   ],
   "scripts": {
-    "setup": "node setup.js"
+    "setup": "node setup.js",
+    "test": "vitest run"
   },
   "keywords": [
     "mcp",
@@ -27,5 +28,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.3",
     "node-fetch": "^2.7.0"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.6"
   }
 }