@rui.branco/sentry-mcp 1.0.3 → 1.0.5

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

@@ -167,7 +167,7 @@ function cleanIssueData(issue) {
 }
 
 function cleanEventData(event) {
-  const skip = new Set(["_meta", "groupID", "eventID", "sdk", "dist", "fingerprints"]);
+  const skip = new Set(["_meta", "groupID", "dist", "fingerprints"]);
   const cleaned = {};
   for (const [k, v] of Object.entries(event)) {
     if (!skip.has(k) && v != null && v !== "") cleaned[k] = v;
@@ -609,6 +609,26 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ["version"],
         },
       },
+      {
+        name: "sentry_list_events",
+        description:
+          "List events for a Sentry issue. Returns event IDs, timestamps, user info, and message/title for each occurrence.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            issueId: {
+              type: "string",
+              description: "Sentry issue ID (numeric).",
+            },
+            instance: {
+              type: "string",
+              description:
+                "Instance name (for multi-instance setups). Uses default instance if omitted.",
+            },
+          },
+          required: ["issueId"],
+        },
+      },
       {
         name: "sentry_list_instances",
         description:
@@ -1013,6 +1033,32 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         content: [{ type: "text", text: lines.join("\n") }],
       };
 
+    } else if (name === "sentry_list_events") {
+      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)}/issues/${encodeURIComponent(args.issueId)}/events/`,
+        inst,
+      );
+      if (!data || !data.length) {
+        return {
+          content: [{ type: "text", text: `No events found for issue ${args.issueId}.` }],
+        };
+      }
+      const lines = data.map((e) => {
+        const user = e.user ? `${e.user.username || e.user.email || e.user.id || "unknown"}` : "N/A";
+        const title = e.title || e.message || "";
+        return `- **${e.eventID || e.id}** | ${e.dateCreated || "N/A"} | User: ${user} | ${title}`;
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Found ${data.length} event(s) for issue ${args.issueId}:\n\n${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.3",
-  "description": "Sentry MCP server for Claude Code - fetch issues, search errors, resolve/ignore issues, get stack traces and breadcrumbs",
+  "version": "1.0.5",
+  "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"