@rui.branco/sentry-mcp 1.0.6 → 1.0.8

package/index.js

@@ -1,1389 +1,1399 @@
-#!/usr/bin/env node
-
-// Handle setup command
-if (process.argv[2] === "setup") {
-  require("./setup.js");
-  process.exit(0);
-}
-
-const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
-const {
-  StdioServerTransport,
-} = require("@modelcontextprotocol/sdk/server/stdio.js");
-const {
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-} = require("@modelcontextprotocol/sdk/types.js");
-const fs = require("fs");
-const os = require("os");
-const path = require("path");
-const fetch = require("node-fetch");
-const { spawn, execSync } = require("child_process");
-
-// Auto-update: check GitHub for new commits, install in background
-const GITHUB_REPO = "rui-branco/sentry-mcp";
-const INSTALLED_SHA_FILE = path.join(__dirname, ".installed-sha");
-try {
-  const localSha = fs.existsSync(INSTALLED_SHA_FILE)
-    ? fs.readFileSync(INSTALLED_SHA_FILE, "utf-8").trim()
-    : "";
-  const remoteSha = execSync(
-    `git ls-remote https://github.com/${GITHUB_REPO}.git HEAD`,
-    { stdio: "pipe", timeout: 5000 },
-  )
-    .toString()
-    .split("\t")[0]
-    .trim();
-  if (remoteSha && remoteSha !== localSha) {
-    const child = spawn(
-      "sh",
-      [
-        "-c",
-        `npm install -g git+ssh://git@github.com/${GITHUB_REPO}.git && echo "${remoteSha}" > "${INSTALLED_SHA_FILE}"`,
-      ],
-      { stdio: "ignore", detached: true },
-    );
-    child.unref();
-  }
-} catch {}
-
-// ── Config ──────────────────────────────────────────────────────────────────
-
-const configDir = path.join(process.env.HOME, ".config/sentry-mcp");
-const configPath = path.join(configDir, "config.json");
-
-function loadConfigFile() {
-  try {
-    return JSON.parse(fs.readFileSync(configPath, "utf8"));
-  } catch {
-    return {};
-  }
-}
-
-// Load config (supports single-instance and multi-instance formats)
-const rawConfig = loadConfigFile();
-
-// Normalize config to multi-instance format
-let instances;
-if (rawConfig.instances) {
-  instances = rawConfig.instances.map((inst) => ({
-    ...inst,
-    projects: (inst.projects || []).map((p) => p.toLowerCase()),
-  }));
-} else if (rawConfig.token) {
-  // Old single-instance format — wrap as array
-  instances = [
-    {
-      name: "default",
-      token: rawConfig.token,
-      baseUrl: (rawConfig.baseUrl || "https://sentry.io").replace(/\/+$/, ""),
-      orgSlug: rawConfig.orgSlug,
-      projectSlug: rawConfig.projectSlug || "",
-      projects: [],
-    },
-  ];
-} else {
-  instances = [];
-}
-
-// Resolve default instance
-const defaultInstance =
-  (rawConfig.defaultInstance &&
-    instances.find((i) => i.name === rawConfig.defaultInstance)) ||
-  instances[0] ||
-  null;
-
-// Instance resolution helpers
-function getInstanceForProject(projectSlug) {
-  if (!projectSlug) return defaultInstance;
-  const lower = projectSlug.toLowerCase();
-  return (
-    instances.find((i) => i.projects.includes(lower)) ||
-    instances.find((i) => i.projectSlug === projectSlug) ||
-    defaultInstance
-  );
-}
-
-function getInstanceByName(name) {
-  if (!name) return defaultInstance;
-  return instances.find((i) => i.name === name) || defaultInstance;
-}
-
-// ── Sentry API ──────────────────────────────────────────────────────────────
-
-async function fetchSentry(apiPath, instance, options = {}) {
-  const inst = instance || defaultInstance;
-  if (!inst) {
-    throw new Error(
-      "No Sentry instance configured. Run: sentry-mcp setup",
-    );
-  }
-  if (!inst.token) {
-    throw new Error(`Sentry API token not configured for instance "${inst.name}".`);
-  }
-
-  const base = (inst.baseUrl || "https://sentry.io").replace(/\/+$/, "");
-  const url = `${base}${apiPath}`;
-  const { method = "GET", body } = options;
-
-  const headers = {
-    Authorization: `Bearer ${inst.token}`,
-    Accept: "application/json",
-  };
-  if (body) {
-    headers["Content-Type"] = "application/json";
-  }
-
-  const response = await fetch(url, {
-    method,
-    headers,
-    body: body ? JSON.stringify(body) : undefined,
-  });
-
-  if (!response.ok) {
-    const errorBody = await response.text().catch(() => "");
-    let errorMsg = `Sentry API error: ${response.status} ${response.statusText}`;
-    try {
-      const parsed = JSON.parse(errorBody);
-      if (parsed.detail) errorMsg = parsed.detail;
-      else if (parsed.message) errorMsg = parsed.message;
-    } catch {}
-    throw new Error(errorMsg);
-  }
-
-  const text = await response.text();
-  return text ? JSON.parse(text) : {};
-}
-
-// Same as fetchSentry but returns the raw response body as a Buffer (for
-// binary downloads like event attachments). Keeps fetchSentry's JSON contract intact.
-async function fetchSentryRaw(apiPath, instance, options = {}) {
-  const inst = instance || defaultInstance;
-  if (!inst) {
-    throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
-  }
-  if (!inst.token) {
-    throw new Error(`Sentry API token not configured for instance "${inst.name}".`);
-  }
-
-  const base = (inst.baseUrl || "https://sentry.io").replace(/\/+$/, "");
-  const url = `${base}${apiPath}`;
-  const { method = "GET" } = options;
-
-  const response = await fetch(url, {
-    method,
-    headers: {
-      Authorization: `Bearer ${inst.token}`,
-      Accept: "*/*",
-    },
-  });
-
-  if (!response.ok) {
-    const errorBody = await response.text().catch(() => "");
-    let errorMsg = `Sentry API error: ${response.status} ${response.statusText}`;
-    try {
-      const parsed = JSON.parse(errorBody);
-      if (parsed.detail) errorMsg = parsed.detail;
-      else if (parsed.message) errorMsg = parsed.message;
-    } catch {}
-    throw new Error(errorMsg);
-  }
-
-  return response.buffer();
-}
-
-// ── Helpers ─────────────────────────────────────────────────────────────────
-
-// Strip noisy/internal fields that waste context but keep everything useful
-function cleanIssueData(issue) {
-  const skip = new Set(["pluginActions", "pluginContexts", "pluginIssues", "activity", "seenBy", "stats"]);
-  const cleaned = {};
-  for (const [k, v] of Object.entries(issue)) {
-    if (!skip.has(k) && v != null && v !== "") cleaned[k] = v;
-  }
-  return cleaned;
-}
-
-function cleanEventData(event) {
-  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;
-  }
-  return cleaned;
-}
-
-// Attachments are event-scoped. Accept a raw eventId (preferred) or resolve
-// the issue's latest event when only an issueId is given.
-async function resolveEventId(args, inst) {
-  if (args.eventId) return args.eventId;
-  if (args.issueId) {
-    const latest = await fetchSentry(
-      `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/issues/${encodeURIComponent(args.issueId)}/events/latest/`,
-      inst,
-    );
-    const id = latest.eventID || latest.id;
-    if (!id) throw new Error(`Could not resolve an event for issue ${args.issueId}.`);
-    return id;
-  }
-  throw new Error("Provide either eventId or issueId.");
-}
-
-// Sanitize a server-provided attachment filename so it can never escape the
-// target directory (path traversal) or introduce awkward characters.
-function safeAttachmentName(name, fallback) {
-  const cleaned = path
-    .basename(String(name || fallback))
-    .replace(/[^a-zA-Z0-9._ -]/g, "_")
-    .replace(/^\.+/, "_")
-    .slice(0, 180);
-  return cleaned || fallback;
-}
-
-// Reduce an id (eventId / attachmentId) to a single safe path segment so it
-// cannot introduce separators or "../" traversal when building the default path.
-function safePathSegment(value, fallback) {
-  const cleaned = path
-    .basename(String(value == null ? "" : value))
-    .replace(/[^a-zA-Z0-9._-]/g, "_")
-    .replace(/^\.+/, "_")
-    .slice(0, 120);
-  return cleaned || fallback;
-}
-
-function formatIssueSummary(issue) {
-  const meta = issue.metadata || {};
-  const lines = [];
-  lines.push(`**${issue.title}**`);
-  lines.push(`- ID: ${issue.id} | Short ID: ${issue.shortId || "N/A"}`);
-  lines.push(`- Level: ${issue.level || "error"} | Status: ${issue.status || "unresolved"}`);
-  lines.push(`- Events: ${issue.count || 0} | Users: ${issue.userCount || 0}`);
-  if (issue.culprit) lines.push(`- Culprit: ${issue.culprit}`);
-  if (meta.filename) lines.push(`- File: ${meta.filename}${meta.function ? " in " + meta.function : ""}`);
-  if (issue.firstSeen) lines.push(`- First seen: ${issue.firstSeen}`);
-  if (issue.lastSeen) lines.push(`- Last seen: ${issue.lastSeen}`);
-  if (issue.permalink) lines.push(`- URL: ${issue.permalink}`);
-  if (issue.assignedTo) {
-    const a = issue.assignedTo;
-    lines.push(`- Assigned to: ${a.name || a.email || a.id || "unknown"}`);
-  }
-  return lines.join("\n");
-}
-
-// ── MCP Server ──────────────────────────────────────────────────────────────
-
-const server = new Server(
-  { name: "sentry-mcp", version: "1.0.0" },
-  { capabilities: { tools: {} } },
-);
-
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return {
-    tools: [
-      {
-        name: "sentry_list_projects",
-        description:
-          "List all Sentry projects accessible by the configured token. When multiple instances are configured, lists projects from each.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            instance: {
-              type: "string",
-              description:
-                "Instance name (for multi-instance setups). Uses default instance if omitted.",
-            },
-          },
-          required: [],
-        },
-      },
-      {
-        name: "sentry_get_issues",
-        description:
-          "Get unresolved issues for a Sentry project. Returns a list of issues with their metadata.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            query: {
-              type: "string",
-              description:
-                'Sentry search query (default: "is:unresolved"). Supports Sentry search syntax.',
-            },
-            instance: {
-              type: "string",
-              description:
-                "Instance name (for multi-instance setups). Uses default instance if omitted.",
-            },
-          },
-          required: [],
-        },
-      },
-      {
-        name: "sentry_get_issue",
-        description:
-          "Get full details for a specific Sentry issue by its numeric ID.",
-        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_get_latest_event",
-        description:
-          "Get the latest event for a Sentry issue — includes full stack trace, breadcrumbs, HTTP request, contexts, and tags.",
-        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_resolve_issue",
-        description: "Mark a Sentry issue as resolved.",
-        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_unresolve_issue",
-        description: "Reopen a resolved Sentry issue.",
-        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_ignore_issue",
-        description: "Ignore/snooze a Sentry issue.",
-        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_search_issues",
-        description:
-          "Search Sentry issues with a custom query. Supports full Sentry search syntax.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            query: {
-              type: "string",
-              description:
-                'Sentry search query (e.g. "is:unresolved level:error", "TypeError", "assigned:me").',
-            },
-            instance: {
-              type: "string",
-              description:
-                "Instance name (for multi-instance setups). Uses default instance if omitted.",
-            },
-          },
-          required: ["query"],
-        },
-      },
-      {
-        name: "sentry_assign_issue",
-        description: "Assign a Sentry issue to a user or team.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            issueId: {
-              type: "string",
-              description: "Sentry issue ID (numeric).",
-            },
-            assignee: {
-              type: "string",
-              description:
-                'Username, email, or team identifier to assign to (e.g. "username:john", "team:backend").',
-            },
-            instance: {
-              type: "string",
-              description:
-                "Instance name (for multi-instance setups). Uses default instance if omitted.",
-            },
-          },
-          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_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_event_attachments",
-        description:
-          "List attachments (minidumps, screenshots, logs, view hierarchies, etc.) stored on a Sentry event. Provide either an eventId (32-char hex) or an issueId (resolves to the issue's latest event). Uses the instance's configured projectSlug.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            eventId: {
-              type: "string",
-              description: "Sentry event ID (32-char hex). Takes precedence over issueId.",
-            },
-            issueId: {
-              type: "string",
-              description: "Sentry issue ID (numeric). If eventId is omitted, the issue's latest event is used.",
-            },
-            instance: {
-              type: "string",
-              description:
-                "Instance name (for multi-instance setups). Uses default instance if omitted.",
-            },
-          },
-          required: [],
-        },
-      },
-      {
-        name: "sentry_download_event_attachment",
-        description:
-          "Download a Sentry event attachment to a file on disk and return the saved path. Provide the attachmentId (from sentry_list_event_attachments) plus either an eventId or issueId. By default saves into a temp directory; pass outputPath to choose a file or destination directory.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            attachmentId: {
-              type: "string",
-              description: "Attachment ID to download (from sentry_list_event_attachments).",
-            },
-            eventId: {
-              type: "string",
-              description: "Sentry event ID (32-char hex). Takes precedence over issueId.",
-            },
-            issueId: {
-              type: "string",
-              description: "Sentry issue ID (numeric). If eventId is omitted, the issue's latest event is used.",
-            },
-            outputPath: {
-              type: "string",
-              description:
-                "Optional destination. If it is an existing directory (or ends with a slash), the file is saved inside it using the attachment's name; otherwise it is treated as the full file path. Relative paths resolve from the current working directory. Defaults to a temp directory.",
-            },
-            instance: {
-              type: "string",
-              description:
-                "Instance name (for multi-instance setups). Uses default instance if omitted.",
-            },
-          },
-          required: ["attachmentId"],
-        },
-      },
-      {
-        name: "sentry_list_instances",
-        description:
-          "List all configured Sentry instances and which is the default.",
-        inputSchema: {
-          type: "object",
-          properties: {},
-          required: [],
-        },
-      },
-      {
-        name: "sentry_add_instance",
-        description:
-          "Add or update a Sentry instance at runtime. Persists to config file.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            name: {
-              type: "string",
-              description: "Instance name (e.g. 'work', 'personal').",
-            },
-            token: {
-              type: "string",
-              description: "Sentry API auth token (Bearer token).",
-            },
-            baseUrl: {
-              type: "string",
-              description:
-                "Sentry base URL (e.g. 'https://sentry.io' or 'https://my-org.sentry.io').",
-            },
-            orgSlug: {
-              type: "string",
-              description: "Sentry organization slug.",
-            },
-            projectSlug: {
-              type: "string",
-              description:
-                "Default Sentry project slug for this instance (optional).",
-            },
-            projects: {
-              type: "array",
-              items: { type: "string" },
-              description:
-                "Project slugs to route to this instance (for multi-instance resolution).",
-            },
-            setDefault: {
-              type: "boolean",
-              description: "Set this as the default instance.",
-            },
-          },
-          required: ["name", "token", "baseUrl", "orgSlug"],
-        },
-      },
-      {
-        name: "sentry_remove_instance",
-        description: "Remove a Sentry instance from the configuration.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            name: {
-              type: "string",
-              description: "Instance name to remove.",
-            },
-          },
-          required: ["name"],
-        },
-      },
-    ],
-  };
-});
-
-// ── Tool handler ────────────────────────────────────────────────────────────
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-
-  try {
-    if (name === "sentry_list_projects") {
-      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)}/projects/`,
-        inst,
-      );
-      if (!data || !data.length) {
-        return {
-          content: [{ type: "text", text: "No projects found." }],
-        };
-      }
-      const lines = data.map(
-        (p) =>
-          `- **${p.name}** (slug: ${p.slug}, platform: ${p.platform || "N/A"}, id: ${p.id})`,
-      );
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Found ${data.length} project(s) in org "${inst.orgSlug}":\n\n${lines.join("\n")}`,
-          },
-        ],
-      };
-
-    } else if (name === "sentry_get_issues") {
-      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. Use sentry_search_issues with org-level search, or configure a projectSlug.");
-      const query = args.query || "is:unresolved";
-      const params = new URLSearchParams({ query });
-      const data = await fetchSentry(
-        `/api/0/projects/${encodeURIComponent(inst.orgSlug)}/${encodeURIComponent(inst.projectSlug)}/issues/?${params}`,
-        inst,
-      );
-      if (!data || !data.length) {
-        return {
-          content: [{ type: "text", text: `No issues found for query: ${query}` }],
-        };
-      }
-      const formatted = data.map(formatIssueSummary);
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Found ${data.length} issue(s) for "${query}":\n\n${formatted.join("\n\n---\n\n")}`,
-          },
-        ],
-      };
-
-    } else if (name === "sentry_get_issue") {
-      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)}/`,
-        inst,
-      );
-      return {
-        content: [{ type: "text", text: JSON.stringify(cleanIssueData(data), null, 2) }],
-      };
-
-    } else if (name === "sentry_get_latest_event") {
-      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/latest/`,
-        inst,
-      );
-      return {
-        content: [{ type: "text", text: JSON.stringify(cleanEventData(data), null, 2) }],
-      };
-
-    } else if (name === "sentry_resolve_issue") {
-      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)}/issues/${encodeURIComponent(args.issueId)}/`,
-        inst,
-        { method: "PUT", body: { status: "resolved" } },
-      );
-      return {
-        content: [{ type: "text", text: `Issue ${args.issueId} marked as resolved.` }],
-      };
-
-    } else if (name === "sentry_unresolve_issue") {
-      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)}/issues/${encodeURIComponent(args.issueId)}/`,
-        inst,
-        { method: "PUT", body: { status: "unresolved" } },
-      );
-      return {
-        content: [{ type: "text", text: `Issue ${args.issueId} reopened (unresolved).` }],
-      };
-
-    } else if (name === "sentry_ignore_issue") {
-      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)}/issues/${encodeURIComponent(args.issueId)}/`,
-        inst,
-        { method: "PUT", body: { status: "ignored" } },
-      );
-      return {
-        content: [{ type: "text", text: `Issue ${args.issueId} ignored.` }],
-      };
-
-    } else if (name === "sentry_search_issues") {
-      const inst = getInstanceByName(args.instance);
-      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
-      // Use project-scoped if projectSlug is available, otherwise org-scoped
-      let apiPath;
-      if (inst.projectSlug) {
-        const params = new URLSearchParams({ query: args.query });
-        apiPath = `/api/0/projects/${encodeURIComponent(inst.orgSlug)}/${encodeURIComponent(inst.projectSlug)}/issues/?${params}`;
-      } else {
-        const params = new URLSearchParams({ query: args.query });
-        apiPath = `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/issues/?${params}`;
-      }
-      const data = await fetchSentry(apiPath, inst);
-      if (!data || !data.length) {
-        return {
-          content: [{ type: "text", text: `No issues found for query: ${args.query}` }],
-        };
-      }
-      const formatted = data.map(formatIssueSummary);
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Found ${data.length} issue(s) for "${args.query}":\n\n${formatted.join("\n\n---\n\n")}`,
-          },
-        ],
-      };
-
-    } else if (name === "sentry_assign_issue") {
-      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)}/issues/${encodeURIComponent(args.issueId)}/`,
-        inst,
-        { method: "PUT", body: { assignedTo: args.assignee } },
-      );
-      return {
-        content: [
-          { type: "text", text: `Issue ${args.issueId} assigned to ${args.assignee}.` },
-        ],
-      };
-
-    } 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_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_event_attachments") {
-      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 eventId = await resolveEventId(args, inst);
-      const data = await fetchSentry(
-        `/api/0/projects/${encodeURIComponent(inst.orgSlug)}/${encodeURIComponent(inst.projectSlug)}/events/${encodeURIComponent(eventId)}/attachments/`,
-        inst,
-      );
-      if (!data || !data.length) {
-        return {
-          content: [{ type: "text", text: `No attachments found for event ${eventId}.` }],
-        };
-      }
-      const lines = data.map((a) => {
-        const size = a.size != null ? ` (${(a.size / 1024).toFixed(1)} KB)` : "";
-        const type = a.type ? `, type: ${a.type}` : "";
-        const mime = a.mimetype ? `, mimetype: ${a.mimetype}` : "";
-        return `- ${a.name}${size} [id: ${a.id}${type}${mime}]`;
-      });
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Found ${data.length} attachment(s) for event ${eventId}:\n\n${lines.join("\n")}\n\nDownload one with sentry_download_event_attachment (attachmentId + eventId/issueId).`,
-          },
-        ],
-      };
-
-    } else if (name === "sentry_download_event_attachment") {
-      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.");
-      if (!args.attachmentId) throw new Error("attachmentId is required.");
-      const eventId = await resolveEventId(args, inst);
-
-      // Look up metadata (name, size, mimetype) so we save with the real filename.
-      const list = await fetchSentry(
-        `/api/0/projects/${encodeURIComponent(inst.orgSlug)}/${encodeURIComponent(inst.projectSlug)}/events/${encodeURIComponent(eventId)}/attachments/`,
-        inst,
-      );
-      const meta = (list || []).find((a) => String(a.id) === String(args.attachmentId));
-      const safeName = safeAttachmentName(meta && meta.name, `attachment-${args.attachmentId}`);
-
-      const buffer = await fetchSentryRaw(
-        `/api/0/projects/${encodeURIComponent(inst.orgSlug)}/${encodeURIComponent(inst.projectSlug)}/events/${encodeURIComponent(eventId)}/attachments/${encodeURIComponent(args.attachmentId)}/?download`,
-        inst,
-      );
-
-      // Resolve destination: explicit path (file or directory) or default temp dir.
-      let destPath;
-      if (args.outputPath) {
-        const resolved = path.resolve(process.cwd(), args.outputPath);
-        const looksLikeDir =
-          /[\\/]$/.test(args.outputPath) ||
-          (fs.existsSync(resolved) && fs.statSync(resolved).isDirectory());
-        destPath = looksLikeDir ? path.join(resolved, safeName) : resolved;
-      } else {
-        destPath = path.join(
-          os.tmpdir(),
-          "sentry-mcp",
-          "attachments",
-          safePathSegment(eventId, "event"),
-          `${safePathSegment(args.attachmentId, "attachment")}-${safeName}`,
-        );
-      }
-      fs.mkdirSync(path.dirname(destPath), { recursive: true });
-      fs.writeFileSync(destPath, buffer);
-
-      const details = {
-        savedPath: destPath,
-        name: (meta && meta.name) || safeName,
-        attachmentId: args.attachmentId,
-        eventId,
-        size: (meta && meta.size != null ? meta.size : buffer.length),
-        mimetype: meta && meta.mimetype ? meta.mimetype : undefined,
-        sha1: meta && meta.sha1 ? meta.sha1 : undefined,
-      };
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Downloaded attachment "${details.name}" (${details.size} bytes) to:\n${destPath}\n\n${JSON.stringify(details, null, 2)}`,
-          },
-        ],
-      };
-
-    } else if (name === "sentry_list_instances") {
-      if (!instances.length) {
-        return {
-          content: [{ type: "text", text: "No Sentry instances configured. Run: sentry-mcp setup" }],
-        };
-      }
-      const lines = instances.map((inst) => {
-        const isDefault = defaultInstance && inst.name === defaultInstance.name ? " (default)" : "";
-        const projs = inst.projects?.length ? ` [${inst.projects.join(", ")}]` : "";
-        return `- **${inst.name}**${isDefault}: ${inst.baseUrl} (org: ${inst.orgSlug}${inst.projectSlug ? ", project: " + inst.projectSlug : ""})${projs}`;
-      });
-      return {
-        content: [
-          {
-            type: "text",
-            text: `${instances.length} instance(s) configured:\n\n${lines.join("\n")}`,
-          },
-        ],
-      };
-
-    } else if (name === "sentry_add_instance") {
-      const config = loadConfigFile();
-      if (!config.instances) config.instances = [];
-
-      const instance = {
-        name: args.name,
-        token: args.token,
-        baseUrl: (args.baseUrl || "https://sentry.io").replace(/\/+$/, ""),
-        orgSlug: args.orgSlug,
-        projectSlug: args.projectSlug || "",
-        projects: (args.projects || []).map((p) => p.toLowerCase()),
-      };
-
-      const idx = config.instances.findIndex((i) => i.name === args.name);
-      if (idx >= 0) {
-        config.instances[idx] = instance;
-      } else {
-        config.instances.push(instance);
-      }
-
-      if (args.setDefault || !config.defaultInstance) {
-        config.defaultInstance = args.name;
-      }
-
-      if (!fs.existsSync(configDir)) {
-        fs.mkdirSync(configDir, { recursive: true });
-      }
-      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-
-      // Update runtime state
-      const normalized = { ...instance, projects: instance.projects };
-      const runtimeIdx = instances.findIndex((i) => i.name === args.name);
-      if (runtimeIdx >= 0) {
-        instances[runtimeIdx] = normalized;
-      } else {
-        instances.push(normalized);
-      }
-
-      return {
-        content: [
-          {
-            type: "text",
-            text: `Instance "${args.name}" saved.${args.setDefault ? " Set as default." : ""}`,
-          },
-        ],
-      };
-
-    } else if (name === "sentry_remove_instance") {
-      const config = loadConfigFile();
-      if (!config.instances) {
-        return {
-          content: [{ type: "text", text: "No instances configured." }],
-        };
-      }
-
-      config.instances = config.instances.filter((i) => i.name !== args.name);
-      if (config.defaultInstance === args.name) {
-        config.defaultInstance = config.instances[0]?.name || null;
-      }
-      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-
-      // Update runtime state
-      const runtimeIdx = instances.findIndex((i) => i.name === args.name);
-      if (runtimeIdx >= 0) instances.splice(runtimeIdx, 1);
-
-      return {
-        content: [
-          { type: "text", text: `Instance "${args.name}" removed.` },
-        ],
-      };
-
-    } else {
-      throw new Error(`Unknown tool: ${name}`);
-    }
-  } catch (error) {
-    return {
-      content: [{ type: "text", text: `Error: ${error.message}` }],
-      isError: true,
-    };
-  }
-});
-
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}
-
-main().catch(console.error);
+#!/usr/bin/env node
+
+// Handle setup command
+if (process.argv[2] === "setup") {
+  require("./setup.js");
+  process.exit(0);
+}
+
+const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
+const {
+  StdioServerTransport,
+} = require("@modelcontextprotocol/sdk/server/stdio.js");
+const {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} = require("@modelcontextprotocol/sdk/types.js");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const fetch = require("node-fetch");
+const { ICONS } = require("./icons.js");
+const { spawn } = require("child_process");
+
+const PKG_VERSION = require("./package.json").version;
+
+// Auto-update: ask the npm registry on every start what the latest published
+// version is, and install it in the background when it isn't the one we're
+// running. The package ships through npm, so there's no git involved: a plain
+// fetch plus an npm install. Runs detached from startup so the server begins
+// serving stdio immediately.
+const NPM_PACKAGE = "@rui.branco/sentry-mcp";
+(async () => {
+  try {
+    const res = await fetch(
+      `https://registry.npmjs.org/${encodeURIComponent(NPM_PACKAGE)}/latest`,
+      { signal: AbortSignal.timeout(5000) },
+    );
+    const latest = (await res.json()).version;
+    if (latest && latest !== PKG_VERSION) {
+      // Passed as one shell string rather than an argv array: npm is npm.cmd on
+      // Windows, and since Node 18.20.2 spawning a .cmd without a shell throws
+      // EINVAL outright (CVE-2024-27980 hardening). shell:true picks cmd.exe
+      // there and /bin/sh elsewhere, so this stays portable — unlike the old
+      // hardcoded `sh`, which simply doesn't exist on Windows. The command is a
+      // fixed literal with no interpolation, so there's nothing to inject.
+      const child = spawn(`npm install -g ${NPM_PACKAGE}`, {
+        shell: true,
+        stdio: "ignore",
+      });
+      // A spawn failure (npm missing from PATH) arrives as an async 'error'
+      // event, which no try/catch around the spawn can see — left unhandled it
+      // would take the whole server down at startup. Swallow it here.
+      child.on("error", () => {});
+    }
+  } catch {
+    /* offline, slow registry, or bad response — no-op */
+  }
+})();
+
+// ── Config ──────────────────────────────────────────────────────────────────
+
+const configDir = path.join(os.homedir(), ".config/sentry-mcp");
+const configPath = path.join(configDir, "config.json");
+
+function loadConfigFile() {
+  try {
+    return JSON.parse(fs.readFileSync(configPath, "utf8"));
+  } catch {
+    return {};
+  }
+}
+
+// Load config (supports single-instance and multi-instance formats)
+const rawConfig = loadConfigFile();
+
+// Normalize config to multi-instance format
+let instances;
+if (rawConfig.instances) {
+  instances = rawConfig.instances.map((inst) => ({
+    ...inst,
+    projects: (inst.projects || []).map((p) => p.toLowerCase()),
+  }));
+} else if (rawConfig.token) {
+  // Old single-instance format — wrap as array
+  instances = [
+    {
+      name: "default",
+      token: rawConfig.token,
+      baseUrl: (rawConfig.baseUrl || "https://sentry.io").replace(/\/+$/, ""),
+      orgSlug: rawConfig.orgSlug,
+      projectSlug: rawConfig.projectSlug || "",
+      projects: [],
+    },
+  ];
+} else {
+  instances = [];
+}
+
+// Resolve default instance
+const defaultInstance =
+  (rawConfig.defaultInstance &&
+    instances.find((i) => i.name === rawConfig.defaultInstance)) ||
+  instances[0] ||
+  null;
+
+// Instance resolution helpers
+function getInstanceForProject(projectSlug) {
+  if (!projectSlug) return defaultInstance;
+  const lower = projectSlug.toLowerCase();
+  return (
+    instances.find((i) => i.projects.includes(lower)) ||
+    instances.find((i) => i.projectSlug === projectSlug) ||
+    defaultInstance
+  );
+}
+
+function getInstanceByName(name) {
+  if (!name) return defaultInstance;
+  return instances.find((i) => i.name === name) || defaultInstance;
+}
+
+// ── Sentry API ──────────────────────────────────────────────────────────────
+
+async function fetchSentry(apiPath, instance, options = {}) {
+  const inst = instance || defaultInstance;
+  if (!inst) {
+    throw new Error(
+      "No Sentry instance configured. Run: sentry-mcp setup",
+    );
+  }
+  if (!inst.token) {
+    throw new Error(`Sentry API token not configured for instance "${inst.name}".`);
+  }
+
+  const base = (inst.baseUrl || "https://sentry.io").replace(/\/+$/, "");
+  const url = `${base}${apiPath}`;
+  const { method = "GET", body } = options;
+
+  const headers = {
+    Authorization: `Bearer ${inst.token}`,
+    Accept: "application/json",
+  };
+  if (body) {
+    headers["Content-Type"] = "application/json";
+  }
+
+  const response = await fetch(url, {
+    method,
+    headers,
+    body: body ? JSON.stringify(body) : undefined,
+  });
+
+  if (!response.ok) {
+    const errorBody = await response.text().catch(() => "");
+    let errorMsg = `Sentry API error: ${response.status} ${response.statusText}`;
+    try {
+      const parsed = JSON.parse(errorBody);
+      if (parsed.detail) errorMsg = parsed.detail;
+      else if (parsed.message) errorMsg = parsed.message;
+    } catch {}
+    throw new Error(errorMsg);
+  }
+
+  const text = await response.text();
+  return text ? JSON.parse(text) : {};
+}
+
+// Same as fetchSentry but returns the raw response body as a Buffer (for
+// binary downloads like event attachments). Keeps fetchSentry's JSON contract intact.
+async function fetchSentryRaw(apiPath, instance, options = {}) {
+  const inst = instance || defaultInstance;
+  if (!inst) {
+    throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+  }
+  if (!inst.token) {
+    throw new Error(`Sentry API token not configured for instance "${inst.name}".`);
+  }
+
+  const base = (inst.baseUrl || "https://sentry.io").replace(/\/+$/, "");
+  const url = `${base}${apiPath}`;
+  const { method = "GET" } = options;
+
+  const response = await fetch(url, {
+    method,
+    headers: {
+      Authorization: `Bearer ${inst.token}`,
+      Accept: "*/*",
+    },
+  });
+
+  if (!response.ok) {
+    const errorBody = await response.text().catch(() => "");
+    let errorMsg = `Sentry API error: ${response.status} ${response.statusText}`;
+    try {
+      const parsed = JSON.parse(errorBody);
+      if (parsed.detail) errorMsg = parsed.detail;
+      else if (parsed.message) errorMsg = parsed.message;
+    } catch {}
+    throw new Error(errorMsg);
+  }
+
+  return response.buffer();
+}
+
+// ── Helpers ─────────────────────────────────────────────────────────────────
+
+// Strip noisy/internal fields that waste context but keep everything useful
+function cleanIssueData(issue) {
+  const skip = new Set(["pluginActions", "pluginContexts", "pluginIssues", "activity", "seenBy", "stats"]);
+  const cleaned = {};
+  for (const [k, v] of Object.entries(issue)) {
+    if (!skip.has(k) && v != null && v !== "") cleaned[k] = v;
+  }
+  return cleaned;
+}
+
+function cleanEventData(event) {
+  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;
+  }
+  return cleaned;
+}
+
+// Attachments are event-scoped. Accept a raw eventId (preferred) or resolve
+// the issue's latest event when only an issueId is given.
+async function resolveEventId(args, inst) {
+  if (args.eventId) return args.eventId;
+  if (args.issueId) {
+    const latest = await fetchSentry(
+      `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/issues/${encodeURIComponent(args.issueId)}/events/latest/`,
+      inst,
+    );
+    const id = latest.eventID || latest.id;
+    if (!id) throw new Error(`Could not resolve an event for issue ${args.issueId}.`);
+    return id;
+  }
+  throw new Error("Provide either eventId or issueId.");
+}
+
+// Sanitize a server-provided attachment filename so it can never escape the
+// target directory (path traversal) or introduce awkward characters.
+function safeAttachmentName(name, fallback) {
+  const cleaned = path
+    .basename(String(name || fallback))
+    .replace(/[^a-zA-Z0-9._ -]/g, "_")
+    .replace(/^\.+/, "_")
+    .slice(0, 180);
+  return cleaned || fallback;
+}
+
+// Reduce an id (eventId / attachmentId) to a single safe path segment so it
+// cannot introduce separators or "../" traversal when building the default path.
+function safePathSegment(value, fallback) {
+  const cleaned = path
+    .basename(String(value == null ? "" : value))
+    .replace(/[^a-zA-Z0-9._-]/g, "_")
+    .replace(/^\.+/, "_")
+    .slice(0, 120);
+  return cleaned || fallback;
+}
+
+function formatIssueSummary(issue) {
+  const meta = issue.metadata || {};
+  const lines = [];
+  lines.push(`**${issue.title}**`);
+  lines.push(`- ID: ${issue.id} | Short ID: ${issue.shortId || "N/A"}`);
+  lines.push(`- Level: ${issue.level || "error"} | Status: ${issue.status || "unresolved"}`);
+  lines.push(`- Events: ${issue.count || 0} | Users: ${issue.userCount || 0}`);
+  if (issue.culprit) lines.push(`- Culprit: ${issue.culprit}`);
+  if (meta.filename) lines.push(`- File: ${meta.filename}${meta.function ? " in " + meta.function : ""}`);
+  if (issue.firstSeen) lines.push(`- First seen: ${issue.firstSeen}`);
+  if (issue.lastSeen) lines.push(`- Last seen: ${issue.lastSeen}`);
+  if (issue.permalink) lines.push(`- URL: ${issue.permalink}`);
+  if (issue.assignedTo) {
+    const a = issue.assignedTo;
+    lines.push(`- Assigned to: ${a.name || a.email || a.id || "unknown"}`);
+  }
+  return lines.join("\n");
+}
+
+// ── MCP Server ──────────────────────────────────────────────────────────────
+
+const server = new Server(
+  { name: "sentry-mcp", version: PKG_VERSION, icons: ICONS },
+  { capabilities: { tools: {} } },
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: "sentry_list_projects",
+        description:
+          "List all Sentry projects accessible by the configured token. When multiple instances are configured, lists projects from each.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            instance: {
+              type: "string",
+              description:
+                "Instance name (for multi-instance setups). Uses default instance if omitted.",
+            },
+          },
+          required: [],
+        },
+      },
+      {
+        name: "sentry_get_issues",
+        description:
+          "Get unresolved issues for a Sentry project. Returns a list of issues with their metadata.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description:
+                'Sentry search query (default: "is:unresolved"). Supports Sentry search syntax.',
+            },
+            instance: {
+              type: "string",
+              description:
+                "Instance name (for multi-instance setups). Uses default instance if omitted.",
+            },
+          },
+          required: [],
+        },
+      },
+      {
+        name: "sentry_get_issue",
+        description:
+          "Get full details for a specific Sentry issue by its numeric ID.",
+        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_get_latest_event",
+        description:
+          "Get the latest event for a Sentry issue — includes full stack trace, breadcrumbs, HTTP request, contexts, and tags.",
+        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_resolve_issue",
+        description: "Mark a Sentry issue as resolved.",
+        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_unresolve_issue",
+        description: "Reopen a resolved Sentry issue.",
+        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_ignore_issue",
+        description: "Ignore/snooze a Sentry issue.",
+        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_search_issues",
+        description:
+          "Search Sentry issues with a custom query. Supports full Sentry search syntax.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: {
+              type: "string",
+              description:
+                'Sentry search query (e.g. "is:unresolved level:error", "TypeError", "assigned:me").',
+            },
+            instance: {
+              type: "string",
+              description:
+                "Instance name (for multi-instance setups). Uses default instance if omitted.",
+            },
+          },
+          required: ["query"],
+        },
+      },
+      {
+        name: "sentry_assign_issue",
+        description: "Assign a Sentry issue to a user or team.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            issueId: {
+              type: "string",
+              description: "Sentry issue ID (numeric).",
+            },
+            assignee: {
+              type: "string",
+              description:
+                'Username, email, or team identifier to assign to (e.g. "username:john", "team:backend").',
+            },
+            instance: {
+              type: "string",
+              description:
+                "Instance name (for multi-instance setups). Uses default instance if omitted.",
+            },
+          },
+          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_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_event_attachments",
+        description:
+          "List attachments (minidumps, screenshots, logs, view hierarchies, etc.) stored on a Sentry event. Provide either an eventId (32-char hex) or an issueId (resolves to the issue's latest event). Uses the instance's configured projectSlug.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            eventId: {
+              type: "string",
+              description: "Sentry event ID (32-char hex). Takes precedence over issueId.",
+            },
+            issueId: {
+              type: "string",
+              description: "Sentry issue ID (numeric). If eventId is omitted, the issue's latest event is used.",
+            },
+            instance: {
+              type: "string",
+              description:
+                "Instance name (for multi-instance setups). Uses default instance if omitted.",
+            },
+          },
+          required: [],
+        },
+      },
+      {
+        name: "sentry_download_event_attachment",
+        description:
+          "Download a Sentry event attachment to a file on disk and return the saved path. Provide the attachmentId (from sentry_list_event_attachments) plus either an eventId or issueId. By default saves into a temp directory; pass outputPath to choose a file or destination directory.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            attachmentId: {
+              type: "string",
+              description: "Attachment ID to download (from sentry_list_event_attachments).",
+            },
+            eventId: {
+              type: "string",
+              description: "Sentry event ID (32-char hex). Takes precedence over issueId.",
+            },
+            issueId: {
+              type: "string",
+              description: "Sentry issue ID (numeric). If eventId is omitted, the issue's latest event is used.",
+            },
+            outputPath: {
+              type: "string",
+              description:
+                "Optional destination. If it is an existing directory (or ends with a slash), the file is saved inside it using the attachment's name; otherwise it is treated as the full file path. Relative paths resolve from the current working directory. Defaults to a temp directory.",
+            },
+            instance: {
+              type: "string",
+              description:
+                "Instance name (for multi-instance setups). Uses default instance if omitted.",
+            },
+          },
+          required: ["attachmentId"],
+        },
+      },
+      {
+        name: "sentry_list_instances",
+        description:
+          "List all configured Sentry instances and which is the default.",
+        inputSchema: {
+          type: "object",
+          properties: {},
+          required: [],
+        },
+      },
+      {
+        name: "sentry_add_instance",
+        description:
+          "Add or update a Sentry instance at runtime. Persists to config file.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: {
+              type: "string",
+              description: "Instance name (e.g. 'work', 'personal').",
+            },
+            token: {
+              type: "string",
+              description: "Sentry API auth token (Bearer token).",
+            },
+            baseUrl: {
+              type: "string",
+              description:
+                "Sentry base URL (e.g. 'https://sentry.io' or 'https://my-org.sentry.io').",
+            },
+            orgSlug: {
+              type: "string",
+              description: "Sentry organization slug.",
+            },
+            projectSlug: {
+              type: "string",
+              description:
+                "Default Sentry project slug for this instance (optional).",
+            },
+            projects: {
+              type: "array",
+              items: { type: "string" },
+              description:
+                "Project slugs to route to this instance (for multi-instance resolution).",
+            },
+            setDefault: {
+              type: "boolean",
+              description: "Set this as the default instance.",
+            },
+          },
+          required: ["name", "token", "baseUrl", "orgSlug"],
+        },
+      },
+      {
+        name: "sentry_remove_instance",
+        description: "Remove a Sentry instance from the configuration.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: {
+              type: "string",
+              description: "Instance name to remove.",
+            },
+          },
+          required: ["name"],
+        },
+      },
+    ],
+  };
+});
+
+// ── Tool handler ────────────────────────────────────────────────────────────
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    if (name === "sentry_list_projects") {
+      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)}/projects/`,
+        inst,
+      );
+      if (!data || !data.length) {
+        return {
+          content: [{ type: "text", text: "No projects found." }],
+        };
+      }
+      const lines = data.map(
+        (p) =>
+          `- **${p.name}** (slug: ${p.slug}, platform: ${p.platform || "N/A"}, id: ${p.id})`,
+      );
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Found ${data.length} project(s) in org "${inst.orgSlug}":\n\n${lines.join("\n")}`,
+          },
+        ],
+      };
+
+    } else if (name === "sentry_get_issues") {
+      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. Use sentry_search_issues with org-level search, or configure a projectSlug.");
+      const query = args.query || "is:unresolved";
+      const params = new URLSearchParams({ query });
+      const data = await fetchSentry(
+        `/api/0/projects/${encodeURIComponent(inst.orgSlug)}/${encodeURIComponent(inst.projectSlug)}/issues/?${params}`,
+        inst,
+      );
+      if (!data || !data.length) {
+        return {
+          content: [{ type: "text", text: `No issues found for query: ${query}` }],
+        };
+      }
+      const formatted = data.map(formatIssueSummary);
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Found ${data.length} issue(s) for "${query}":\n\n${formatted.join("\n\n---\n\n")}`,
+          },
+        ],
+      };
+
+    } else if (name === "sentry_get_issue") {
+      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)}/`,
+        inst,
+      );
+      return {
+        content: [{ type: "text", text: JSON.stringify(cleanIssueData(data), null, 2) }],
+      };
+
+    } else if (name === "sentry_get_latest_event") {
+      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/latest/`,
+        inst,
+      );
+      return {
+        content: [{ type: "text", text: JSON.stringify(cleanEventData(data), null, 2) }],
+      };
+
+    } else if (name === "sentry_resolve_issue") {
+      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)}/issues/${encodeURIComponent(args.issueId)}/`,
+        inst,
+        { method: "PUT", body: { status: "resolved" } },
+      );
+      return {
+        content: [{ type: "text", text: `Issue ${args.issueId} marked as resolved.` }],
+      };
+
+    } else if (name === "sentry_unresolve_issue") {
+      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)}/issues/${encodeURIComponent(args.issueId)}/`,
+        inst,
+        { method: "PUT", body: { status: "unresolved" } },
+      );
+      return {
+        content: [{ type: "text", text: `Issue ${args.issueId} reopened (unresolved).` }],
+      };
+
+    } else if (name === "sentry_ignore_issue") {
+      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)}/issues/${encodeURIComponent(args.issueId)}/`,
+        inst,
+        { method: "PUT", body: { status: "ignored" } },
+      );
+      return {
+        content: [{ type: "text", text: `Issue ${args.issueId} ignored.` }],
+      };
+
+    } else if (name === "sentry_search_issues") {
+      const inst = getInstanceByName(args.instance);
+      if (!inst) throw new Error("No Sentry instance configured. Run: sentry-mcp setup");
+      // Use project-scoped if projectSlug is available, otherwise org-scoped
+      let apiPath;
+      if (inst.projectSlug) {
+        const params = new URLSearchParams({ query: args.query });
+        apiPath = `/api/0/projects/${encodeURIComponent(inst.orgSlug)}/${encodeURIComponent(inst.projectSlug)}/issues/?${params}`;
+      } else {
+        const params = new URLSearchParams({ query: args.query });
+        apiPath = `/api/0/organizations/${encodeURIComponent(inst.orgSlug)}/issues/?${params}`;
+      }
+      const data = await fetchSentry(apiPath, inst);
+      if (!data || !data.length) {
+        return {
+          content: [{ type: "text", text: `No issues found for query: ${args.query}` }],
+        };
+      }
+      const formatted = data.map(formatIssueSummary);
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Found ${data.length} issue(s) for "${args.query}":\n\n${formatted.join("\n\n---\n\n")}`,
+          },
+        ],
+      };
+
+    } else if (name === "sentry_assign_issue") {
+      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)}/issues/${encodeURIComponent(args.issueId)}/`,
+        inst,
+        { method: "PUT", body: { assignedTo: args.assignee } },
+      );
+      return {
+        content: [
+          { type: "text", text: `Issue ${args.issueId} assigned to ${args.assignee}.` },
+        ],
+      };
+
+    } 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_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_event_attachments") {
+      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 eventId = await resolveEventId(args, inst);
+      const data = await fetchSentry(
+        `/api/0/projects/${encodeURIComponent(inst.orgSlug)}/${encodeURIComponent(inst.projectSlug)}/events/${encodeURIComponent(eventId)}/attachments/`,
+        inst,
+      );
+      if (!data || !data.length) {
+        return {
+          content: [{ type: "text", text: `No attachments found for event ${eventId}.` }],
+        };
+      }
+      const lines = data.map((a) => {
+        const size = a.size != null ? ` (${(a.size / 1024).toFixed(1)} KB)` : "";
+        const type = a.type ? `, type: ${a.type}` : "";
+        const mime = a.mimetype ? `, mimetype: ${a.mimetype}` : "";
+        return `- ${a.name}${size} [id: ${a.id}${type}${mime}]`;
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Found ${data.length} attachment(s) for event ${eventId}:\n\n${lines.join("\n")}\n\nDownload one with sentry_download_event_attachment (attachmentId + eventId/issueId).`,
+          },
+        ],
+      };
+
+    } else if (name === "sentry_download_event_attachment") {
+      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.");
+      if (!args.attachmentId) throw new Error("attachmentId is required.");
+      const eventId = await resolveEventId(args, inst);
+
+      // Look up metadata (name, size, mimetype) so we save with the real filename.
+      const list = await fetchSentry(
+        `/api/0/projects/${encodeURIComponent(inst.orgSlug)}/${encodeURIComponent(inst.projectSlug)}/events/${encodeURIComponent(eventId)}/attachments/`,
+        inst,
+      );
+      const meta = (list || []).find((a) => String(a.id) === String(args.attachmentId));
+      const safeName = safeAttachmentName(meta && meta.name, `attachment-${args.attachmentId}`);
+
+      const buffer = await fetchSentryRaw(
+        `/api/0/projects/${encodeURIComponent(inst.orgSlug)}/${encodeURIComponent(inst.projectSlug)}/events/${encodeURIComponent(eventId)}/attachments/${encodeURIComponent(args.attachmentId)}/?download`,
+        inst,
+      );
+
+      // Resolve destination: explicit path (file or directory) or default temp dir.
+      let destPath;
+      if (args.outputPath) {
+        const resolved = path.resolve(process.cwd(), args.outputPath);
+        const looksLikeDir =
+          /[\\/]$/.test(args.outputPath) ||
+          (fs.existsSync(resolved) && fs.statSync(resolved).isDirectory());
+        destPath = looksLikeDir ? path.join(resolved, safeName) : resolved;
+      } else {
+        destPath = path.join(
+          os.tmpdir(),
+          "sentry-mcp",
+          "attachments",
+          safePathSegment(eventId, "event"),
+          `${safePathSegment(args.attachmentId, "attachment")}-${safeName}`,
+        );
+      }
+      fs.mkdirSync(path.dirname(destPath), { recursive: true });
+      fs.writeFileSync(destPath, buffer);
+
+      const details = {
+        savedPath: destPath,
+        name: (meta && meta.name) || safeName,
+        attachmentId: args.attachmentId,
+        eventId,
+        size: (meta && meta.size != null ? meta.size : buffer.length),
+        mimetype: meta && meta.mimetype ? meta.mimetype : undefined,
+        sha1: meta && meta.sha1 ? meta.sha1 : undefined,
+      };
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Downloaded attachment "${details.name}" (${details.size} bytes) to:\n${destPath}\n\n${JSON.stringify(details, null, 2)}`,
+          },
+        ],
+      };
+
+    } else if (name === "sentry_list_instances") {
+      if (!instances.length) {
+        return {
+          content: [{ type: "text", text: "No Sentry instances configured. Run: sentry-mcp setup" }],
+        };
+      }
+      const lines = instances.map((inst) => {
+        const isDefault = defaultInstance && inst.name === defaultInstance.name ? " (default)" : "";
+        const projs = inst.projects?.length ? ` [${inst.projects.join(", ")}]` : "";
+        return `- **${inst.name}**${isDefault}: ${inst.baseUrl} (org: ${inst.orgSlug}${inst.projectSlug ? ", project: " + inst.projectSlug : ""})${projs}`;
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: `${instances.length} instance(s) configured:\n\n${lines.join("\n")}`,
+          },
+        ],
+      };
+
+    } else if (name === "sentry_add_instance") {
+      const config = loadConfigFile();
+      if (!config.instances) config.instances = [];
+
+      const instance = {
+        name: args.name,
+        token: args.token,
+        baseUrl: (args.baseUrl || "https://sentry.io").replace(/\/+$/, ""),
+        orgSlug: args.orgSlug,
+        projectSlug: args.projectSlug || "",
+        projects: (args.projects || []).map((p) => p.toLowerCase()),
+      };
+
+      const idx = config.instances.findIndex((i) => i.name === args.name);
+      if (idx >= 0) {
+        config.instances[idx] = instance;
+      } else {
+        config.instances.push(instance);
+      }
+
+      if (args.setDefault || !config.defaultInstance) {
+        config.defaultInstance = args.name;
+      }
+
+      if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+      }
+      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+
+      // Update runtime state
+      const normalized = { ...instance, projects: instance.projects };
+      const runtimeIdx = instances.findIndex((i) => i.name === args.name);
+      if (runtimeIdx >= 0) {
+        instances[runtimeIdx] = normalized;
+      } else {
+        instances.push(normalized);
+      }
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Instance "${args.name}" saved.${args.setDefault ? " Set as default." : ""}`,
+          },
+        ],
+      };
+
+    } else if (name === "sentry_remove_instance") {
+      const config = loadConfigFile();
+      if (!config.instances) {
+        return {
+          content: [{ type: "text", text: "No instances configured." }],
+        };
+      }
+
+      config.instances = config.instances.filter((i) => i.name !== args.name);
+      if (config.defaultInstance === args.name) {
+        config.defaultInstance = config.instances[0]?.name || null;
+      }
+      fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+
+      // Update runtime state
+      const runtimeIdx = instances.findIndex((i) => i.name === args.name);
+      if (runtimeIdx >= 0) instances.splice(runtimeIdx, 1);
+
+      return {
+        content: [
+          { type: "text", text: `Instance "${args.name}" removed.` },
+        ],
+      };
+
+    } else {
+      throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (error) {
+    return {
+      content: [{ type: "text", text: `Error: ${error.message}` }],
+      isError: true,
+    };
+  }
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch(console.error);