@tokamohsen/sentry-mcp 0.29.0

package/dist/cli/usage-B0gAPy4S.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-B0gAPy4S.d.cts","names":[],"sources":["../../src/cli/usage.ts"],"sourcesContent":[],"mappings":";;;iBAEgB,UAAA,iCAEH,cAAc"}

package/dist/cli/usage-BMxqEEQ3.d.ts

@@ -0,0 +1,9 @@
+import { Skill } from "@sentry/mcp-core/skills";
+
+//#region src/cli/usage.d.ts
+declare function buildUsage(packageName: string, allSkills: ReadonlyArray<Skill>): string;
+//# sourceMappingURL=usage.d.ts.map
+
+//#endregion
+export { buildUsage };
+//# sourceMappingURL=usage-BMxqEEQ3.d.ts.map

package/dist/cli/usage-BMxqEEQ3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-BMxqEEQ3.d.ts","names":[],"sources":["../../src/cli/usage.ts"],"sourcesContent":[],"mappings":";;;iBAEgB,UAAA,iCAEH,cAAc"}

package/dist/cli/usage.cjs

@@ -0,0 +1,47 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+//#region src/cli/usage.ts
+function buildUsage(packageName, allSkills) {
+	return `Usage: ${packageName} --access-token=<token> [--host=<host>]
+
+Required:
+  --access-token <token>  Sentry User Auth Token with API access
+
+Common optional flags:
+  --host <host>           Change Sentry host (self-hosted)
+  --sentry-dsn <dsn>      Override DSN used for telemetry reporting
+  --agent                 Agent mode: only expose use_sentry tool (for AI agents)
+  --experimental          Enable experimental tools (hidden by default)
+
+Embedded agent configuration:
+  --agent-provider <provider>   LLM provider: openai or anthropic (auto-detects from API keys)
+  --openai-base-url <url>       Override OpenAI API base URL
+  --openai-model <model>        Override OpenAI model (default: gpt-5)
+  --anthropic-base-url <url>    Override Anthropic API base URL
+  --anthropic-model <model>     Override Anthropic model (default: claude-sonnet-4-5)
+
+Session constraints:
+  --organization-slug <slug>  Force all calls to an organization
+  --project-slug <slug>       Optional project constraint
+
+Skill controls:
+  --skills <list>     Specify which skills to grant (default: all skills)
+
+All skills: ${allSkills.join(", ")}
+
+Environment variables:
+  SENTRY_ACCESS_TOKEN     Sentry auth token (alternative to --access-token)
+  OPENAI_API_KEY          OpenAI API key for AI-powered search tools
+  ANTHROPIC_API_KEY       Anthropic API key for AI-powered search tools
+  EMBEDDED_AGENT_PROVIDER Provider override: openai or anthropic
+
+Examples:
+  ${packageName} --access-token=TOKEN
+  ${packageName} --access-token=TOKEN --skills=inspect,triage
+  ${packageName} --access-token=TOKEN --host=sentry.example.com
+  ${packageName} --access-token=TOKEN --agent-provider=anthropic`;
+}
+
+//#endregion
+exports.buildUsage = buildUsage;
+//# sourceMappingURL=usage.cjs.map

package/dist/cli/usage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.cjs","names":[],"sources":["../../src/cli/usage.ts"],"sourcesContent":["import type { Skill } from \"@sentry/mcp-core/skills\";\n\nexport function buildUsage(\n  packageName: string,\n  allSkills: ReadonlyArray<Skill>,\n): string {\n  return `Usage: ${packageName} --access-token=<token> [--host=<host>]\n\nRequired:\n  --access-token <token>  Sentry User Auth Token with API access\n\nCommon optional flags:\n  --host <host>           Change Sentry host (self-hosted)\n  --sentry-dsn <dsn>      Override DSN used for telemetry reporting\n  --agent                 Agent mode: only expose use_sentry tool (for AI agents)\n  --experimental          Enable experimental tools (hidden by default)\n\nEmbedded agent configuration:\n  --agent-provider <provider>   LLM provider: openai or anthropic (auto-detects from API keys)\n  --openai-base-url <url>       Override OpenAI API base URL\n  --openai-model <model>        Override OpenAI model (default: gpt-5)\n  --anthropic-base-url <url>    Override Anthropic API base URL\n  --anthropic-model <model>     Override Anthropic model (default: claude-sonnet-4-5)\n\nSession constraints:\n  --organization-slug <slug>  Force all calls to an organization\n  --project-slug <slug>       Optional project constraint\n\nSkill controls:\n  --skills <list>     Specify which skills to grant (default: all skills)\n\nAll skills: ${allSkills.join(\", \")}\n\nEnvironment variables:\n  SENTRY_ACCESS_TOKEN     Sentry auth token (alternative to --access-token)\n  OPENAI_API_KEY          OpenAI API key for AI-powered search tools\n  ANTHROPIC_API_KEY       Anthropic API key for AI-powered search tools\n  EMBEDDED_AGENT_PROVIDER Provider override: openai or anthropic\n\nExamples:\n  ${packageName} --access-token=TOKEN\n  ${packageName} --access-token=TOKEN --skills=inspect,triage\n  ${packageName} --access-token=TOKEN --host=sentry.example.com\n  ${packageName} --access-token=TOKEN --agent-provider=anthropic`;\n}\n"],"mappings":";;;AAEA,SAAgB,WACd,aACA,WACQ;AACR,QAAO,UAAU,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;cAyBjB,UAAU,KAAK,KAAK,CAAC;;;;;;;;;IAS/B,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,YAAY"}

package/dist/cli/usage.js

@@ -0,0 +1,45 @@
+//#region src/cli/usage.ts
+function buildUsage(packageName, allSkills) {
+	return `Usage: ${packageName} --access-token=<token> [--host=<host>]
+
+Required:
+  --access-token <token>  Sentry User Auth Token with API access
+
+Common optional flags:
+  --host <host>           Change Sentry host (self-hosted)
+  --sentry-dsn <dsn>      Override DSN used for telemetry reporting
+  --agent                 Agent mode: only expose use_sentry tool (for AI agents)
+  --experimental          Enable experimental tools (hidden by default)
+
+Embedded agent configuration:
+  --agent-provider <provider>   LLM provider: openai or anthropic (auto-detects from API keys)
+  --openai-base-url <url>       Override OpenAI API base URL
+  --openai-model <model>        Override OpenAI model (default: gpt-5)
+  --anthropic-base-url <url>    Override Anthropic API base URL
+  --anthropic-model <model>     Override Anthropic model (default: claude-sonnet-4-5)
+
+Session constraints:
+  --organization-slug <slug>  Force all calls to an organization
+  --project-slug <slug>       Optional project constraint
+
+Skill controls:
+  --skills <list>     Specify which skills to grant (default: all skills)
+
+All skills: ${allSkills.join(", ")}
+
+Environment variables:
+  SENTRY_ACCESS_TOKEN     Sentry auth token (alternative to --access-token)
+  OPENAI_API_KEY          OpenAI API key for AI-powered search tools
+  ANTHROPIC_API_KEY       Anthropic API key for AI-powered search tools
+  EMBEDDED_AGENT_PROVIDER Provider override: openai or anthropic
+
+Examples:
+  ${packageName} --access-token=TOKEN
+  ${packageName} --access-token=TOKEN --skills=inspect,triage
+  ${packageName} --access-token=TOKEN --host=sentry.example.com
+  ${packageName} --access-token=TOKEN --agent-provider=anthropic`;
+}
+
+//#endregion
+export { buildUsage };
+//# sourceMappingURL=usage.js.map

package/dist/cli/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","names":[],"sources":["../../src/cli/usage.ts"],"sourcesContent":["import type { Skill } from \"@sentry/mcp-core/skills\";\n\nexport function buildUsage(\n  packageName: string,\n  allSkills: ReadonlyArray<Skill>,\n): string {\n  return `Usage: ${packageName} --access-token=<token> [--host=<host>]\n\nRequired:\n  --access-token <token>  Sentry User Auth Token with API access\n\nCommon optional flags:\n  --host <host>           Change Sentry host (self-hosted)\n  --sentry-dsn <dsn>      Override DSN used for telemetry reporting\n  --agent                 Agent mode: only expose use_sentry tool (for AI agents)\n  --experimental          Enable experimental tools (hidden by default)\n\nEmbedded agent configuration:\n  --agent-provider <provider>   LLM provider: openai or anthropic (auto-detects from API keys)\n  --openai-base-url <url>       Override OpenAI API base URL\n  --openai-model <model>        Override OpenAI model (default: gpt-5)\n  --anthropic-base-url <url>    Override Anthropic API base URL\n  --anthropic-model <model>     Override Anthropic model (default: claude-sonnet-4-5)\n\nSession constraints:\n  --organization-slug <slug>  Force all calls to an organization\n  --project-slug <slug>       Optional project constraint\n\nSkill controls:\n  --skills <list>     Specify which skills to grant (default: all skills)\n\nAll skills: ${allSkills.join(\", \")}\n\nEnvironment variables:\n  SENTRY_ACCESS_TOKEN     Sentry auth token (alternative to --access-token)\n  OPENAI_API_KEY          OpenAI API key for AI-powered search tools\n  ANTHROPIC_API_KEY       Anthropic API key for AI-powered search tools\n  EMBEDDED_AGENT_PROVIDER Provider override: openai or anthropic\n\nExamples:\n  ${packageName} --access-token=TOKEN\n  ${packageName} --access-token=TOKEN --skills=inspect,triage\n  ${packageName} --access-token=TOKEN --host=sentry.example.com\n  ${packageName} --access-token=TOKEN --agent-provider=anthropic`;\n}\n"],"mappings":";AAEA,SAAgB,WACd,aACA,WACQ;AACR,QAAO,UAAU,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;cAyBjB,UAAU,KAAK,KAAK,CAAC;;;;;;;;;IAS/B,YAAY;IACZ,YAAY;IACZ,YAAY;IACZ,YAAY"}

package/dist/index-16fTC-hT.d.cts

@@ -0,0 +1 @@
+export {};

package/dist/index-DgNgxUxv.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.cjs

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+const require_chunk = require('./chunk-C0xms8kb.cjs');
+const require_transports_stdio = require('./transports/stdio.cjs');
+const require_cli_usage = require('./cli/usage.cjs');
+const require_cli_parse = require('./cli/parse.cjs');
+const require_cli_resolve = require('./cli/resolve.cjs');
+let _sentry_mcp_core_server = require("@sentry/mcp-core/server");
+let _sentry_node = require("@sentry/node");
+_sentry_node = require_chunk.__toESM(_sentry_node);
+let _sentry_mcp_core_version = require("@sentry/mcp-core/version");
+let _sentry_mcp_core_skills = require("@sentry/mcp-core/skills");
+let _sentry_mcp_core_telem_sentry = require("@sentry/mcp-core/telem/sentry");
+let _sentry_mcp_core_internal_agents_provider_factory = require("@sentry/mcp-core/internal/agents/provider-factory");
+
+//#region src/index.ts
+/**
+* Main CLI entry point for the Sentry MCP server.
+*
+* Handles command-line argument parsing, environment configuration, Sentry
+* initialization, and starts the MCP server with stdio transport. Requires
+* a Sentry access token and optionally accepts host and DSN configuration.
+*
+* @example CLI Usage
+* ```bash
+* npx @sentry/mcp-server --access-token=TOKEN --host=sentry.io
+* npx @sentry/mcp-server --access-token=TOKEN --url=https://sentry.example.com
+* ```
+*/
+const packageName = "@sentry/mcp-server";
+const usageText = require_cli_usage.buildUsage(packageName, Object.keys(_sentry_mcp_core_skills.SKILLS));
+function die(message) {
+	console.error(message);
+	console.error(usageText);
+	process.exit(1);
+}
+const cli = require_cli_parse.parseArgv(process.argv.slice(2));
+if (cli.help) {
+	console.log(usageText);
+	process.exit(0);
+}
+if (cli.version) {
+	console.log(`${packageName} ${_sentry_mcp_core_version.LIB_VERSION}`);
+	process.exit(0);
+}
+if (cli.unknownArgs.length > 0) {
+	console.error("Error: Invalid argument(s):", cli.unknownArgs.join(", "));
+	console.error(usageText);
+	process.exit(1);
+}
+const env = require_cli_parse.parseEnv(process.env);
+const cfg = (() => {
+	try {
+		return require_cli_resolve.finalize(require_cli_parse.merge(cli, env));
+	} catch (err) {
+		die(err instanceof Error ? err.message : String(err));
+	}
+})();
+if (cfg.agentProvider) (0, _sentry_mcp_core_internal_agents_provider_factory.setAgentProvider)(cfg.agentProvider);
+(0, _sentry_mcp_core_internal_agents_provider_factory.setProviderBaseUrls)({
+	openaiBaseUrl: cfg.openaiBaseUrl,
+	anthropicBaseUrl: cfg.anthropicBaseUrl
+});
+if (cfg.openaiModel) process.env.OPENAI_MODEL = cfg.openaiModel;
+if (cfg.anthropicModel) process.env.ANTHROPIC_MODEL = cfg.anthropicModel;
+function hasProviderConflict() {
+	const hasAnthropic = Boolean(process.env.ANTHROPIC_API_KEY);
+	const hasOpenAI = Boolean(process.env.OPENAI_API_KEY);
+	const hasExplicitProvider = cfg.agentProvider || process.env.EMBEDDED_AGENT_PROVIDER;
+	return hasAnthropic && hasOpenAI && !hasExplicitProvider;
+}
+function getConfiguredProvider() {
+	return cfg.agentProvider || process.env.EMBEDDED_AGENT_PROVIDER?.toLowerCase();
+}
+function hasProviderMismatch() {
+	const configured = getConfiguredProvider();
+	if (!configured) return { mismatch: false };
+	const hasAnthropic = Boolean(process.env.ANTHROPIC_API_KEY);
+	const hasOpenAI = Boolean(process.env.OPENAI_API_KEY);
+	if (configured === "openai" && !hasOpenAI && hasAnthropic) return {
+		mismatch: true,
+		configured: "openai",
+		availableKey: "ANTHROPIC_API_KEY"
+	};
+	if (configured === "anthropic" && !hasAnthropic && hasOpenAI) return {
+		mismatch: true,
+		configured: "anthropic",
+		availableKey: "OPENAI_API_KEY"
+	};
+	return { mismatch: false };
+}
+function getProviderSource() {
+	if (cli.agentProvider) return "explicitly configured";
+	if (process.env.EMBEDDED_AGENT_PROVIDER) return "from EMBEDDED_AGENT_PROVIDER";
+	return "auto-detected";
+}
+const resolvedProvider = (0, _sentry_mcp_core_internal_agents_provider_factory.getResolvedProviderType)();
+if (!resolvedProvider) {
+	const mismatchInfo = hasProviderMismatch();
+	if (hasProviderConflict()) {
+		console.warn("Warning: Both ANTHROPIC_API_KEY and OPENAI_API_KEY are set, but no provider is explicitly configured.");
+		console.warn("Please set EMBEDDED_AGENT_PROVIDER='openai' or 'anthropic' to specify which provider to use.");
+		console.warn("AI-powered search tools will be unavailable until a provider is selected.");
+	} else if (mismatchInfo.mismatch) {
+		const expectedKey = mismatchInfo.configured === "openai" ? "OPENAI_API_KEY" : "ANTHROPIC_API_KEY";
+		const configuredViaCliFlag = Boolean(cli.agentProvider);
+		const providerSetting = configuredViaCliFlag ? `--agent-provider=${mismatchInfo.configured}` : `EMBEDDED_AGENT_PROVIDER='${mismatchInfo.configured}'`;
+		const changeProviderHint = configuredViaCliFlag ? "Change --agent-provider to match your available API key" : "Change EMBEDDED_AGENT_PROVIDER to match your available API key";
+		console.warn(`Warning: ${providerSetting} but ${expectedKey} is not set.`);
+		console.warn(`Found ${mismatchInfo.availableKey} instead. Either:`);
+		console.warn(`  - Set ${expectedKey} to use the ${mismatchInfo.configured} provider, or`);
+		console.warn(`  - ${changeProviderHint}`);
+		console.warn("AI-powered search tools will be unavailable until this is resolved.");
+	} else {
+		console.warn("Warning: No LLM API key found (OPENAI_API_KEY or ANTHROPIC_API_KEY).");
+		console.warn("The following AI-powered search tools will be unavailable:");
+		console.warn("  - search_events, search_issues, search_issue_events, use_sentry");
+		console.warn("Use list_issues and list_events for direct Sentry query syntax instead.");
+	}
+	console.warn("");
+} else {
+	const providerSource = getProviderSource();
+	console.warn(`Using ${resolvedProvider} for AI-powered search tools (${providerSource}).`);
+	if (providerSource === "auto-detected") {
+		console.warn("Deprecation warning: Auto-detection of LLM provider is deprecated.");
+		console.warn(`Please set EMBEDDED_AGENT_PROVIDER='${resolvedProvider}' explicitly.`);
+		console.warn("Auto-detection will be removed in a future release.");
+	}
+	console.warn("");
+}
+_sentry_node.init({
+	dsn: cfg.sentryDsn,
+	sendDefaultPii: true,
+	tracesSampleRate: 1,
+	beforeSend: _sentry_mcp_core_telem_sentry.sentryBeforeSend,
+	initialScope: { tags: {
+		"mcp.server_version": _sentry_mcp_core_version.LIB_VERSION,
+		"mcp.transport": "stdio",
+		"mcp.agent_mode": cli.agent ? "true" : "false",
+		"mcp.experimental_mode": cli.experimental ? "true" : "false",
+		"sentry.host": cfg.sentryHost,
+		"mcp.mcp-url": cfg.mcpUrl
+	} },
+	release: process.env.SENTRY_RELEASE,
+	integrations: [
+		_sentry_node.consoleLoggingIntegration(),
+		_sentry_node.zodErrorsIntegration(),
+		_sentry_node.vercelAIIntegration({
+			recordInputs: true,
+			recordOutputs: true
+		})
+	],
+	environment: process.env.SENTRY_ENVIRONMENT ?? (process.env.NODE_ENV !== "production" ? "development" : "production")
+});
+if (cli.agent) {
+	console.warn("Agent mode enabled: Only use_sentry tool is available.");
+	console.warn("The use_sentry tool provides access to all Sentry operations through natural language.");
+	console.warn("");
+}
+if (cli.experimental) {
+	console.warn("Experimental mode enabled: Experimental tools are available.");
+	console.warn("");
+}
+const SENTRY_TIMEOUT = 5e3;
+async function shutdown(signal) {
+	console.error(`${signal} received, shutting down...`);
+	await _sentry_node.flush(SENTRY_TIMEOUT);
+	process.exit(0);
+}
+process.on("SIGTERM", () => shutdown("SIGTERM"));
+process.on("SIGINT", () => shutdown("SIGINT"));
+process.on("uncaughtException", async (error) => {
+	console.error("Uncaught exception:", error);
+	_sentry_node.captureException(error);
+	await _sentry_node.flush(SENTRY_TIMEOUT);
+	process.exit(1);
+});
+process.on("unhandledRejection", async (reason) => {
+	console.error("Unhandled rejection:", reason);
+	_sentry_node.captureException(reason);
+	await _sentry_node.flush(SENTRY_TIMEOUT);
+	process.exit(1);
+});
+const context = {
+	accessToken: cfg.accessToken,
+	grantedSkills: cfg.finalSkills,
+	constraints: {
+		organizationSlug: cfg.organizationSlug ?? null,
+		projectSlug: cfg.projectSlug ?? null
+	},
+	sentryHost: cfg.sentryHost,
+	mcpUrl: cfg.mcpUrl,
+	openaiBaseUrl: cfg.openaiBaseUrl,
+	agentMode: cli.agent,
+	experimentalMode: cli.experimental
+};
+require_transports_stdio.startStdio((0, _sentry_mcp_core_server.buildServer)({
+	context,
+	agentMode: cli.agent,
+	experimentalMode: cli.experimental
+}), context).catch(async (err) => {
+	console.error("Server error:", err);
+	_sentry_node.captureException(err);
+	await _sentry_node.flush(SENTRY_TIMEOUT);
+	process.exit(1);
+});
+
+//#endregion
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["buildUsage","SKILLS","parseArgv","LIB_VERSION","parseEnv","finalize","merge","Sentry","sentryBeforeSend","startStdio"],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * Main CLI entry point for the Sentry MCP server.\n *\n * Handles command-line argument parsing, environment configuration, Sentry\n * initialization, and starts the MCP server with stdio transport. Requires\n * a Sentry access token and optionally accepts host and DSN configuration.\n *\n * @example CLI Usage\n * ```bash\n * npx @sentry/mcp-server --access-token=TOKEN --host=sentry.io\n * npx @sentry/mcp-server --access-token=TOKEN --url=https://sentry.example.com\n * ```\n */\n\nimport { buildServer } from \"@sentry/mcp-core/server\";\nimport { startStdio } from \"./transports/stdio\";\nimport * as Sentry from \"@sentry/node\";\nimport { LIB_VERSION } from \"@sentry/mcp-core/version\";\nimport { buildUsage } from \"./cli/usage\";\nimport { parseArgv, parseEnv, merge } from \"./cli/parse\";\nimport { finalize } from \"./cli/resolve\";\nimport { sentryBeforeSend } from \"@sentry/mcp-core/telem/sentry\";\nimport { SKILLS } from \"@sentry/mcp-core/skills\";\nimport {\n  setAgentProvider,\n  setProviderBaseUrls,\n  getResolvedProviderType,\n} from \"@sentry/mcp-core/internal/agents/provider-factory\";\n\nconst packageName = \"@sentry/mcp-server\";\nconst allSkills = Object.keys(SKILLS) as ReadonlyArray<\n  (typeof SKILLS)[keyof typeof SKILLS][\"id\"]\n>;\nconst usageText = buildUsage(packageName, allSkills);\n\nfunction die(message: string): never {\n  console.error(message);\n  console.error(usageText);\n  process.exit(1);\n}\nconst cli = parseArgv(process.argv.slice(2));\nif (cli.help) {\n  console.log(usageText);\n  process.exit(0);\n}\nif (cli.version) {\n  console.log(`${packageName} ${LIB_VERSION}`);\n  process.exit(0);\n}\nif (cli.unknownArgs.length > 0) {\n  console.error(\"Error: Invalid argument(s):\", cli.unknownArgs.join(\", \"));\n  console.error(usageText);\n  process.exit(1);\n}\n\nconst env = parseEnv(process.env);\nconst cfg = (() => {\n  try {\n    return finalize(merge(cli, env));\n  } catch (err) {\n    die(err instanceof Error ? err.message : String(err));\n  }\n})();\n\n// Configure embedded agent provider\nif (cfg.agentProvider) {\n  setAgentProvider(cfg.agentProvider);\n}\nsetProviderBaseUrls({\n  openaiBaseUrl: cfg.openaiBaseUrl,\n  anthropicBaseUrl: cfg.anthropicBaseUrl,\n});\nif (cfg.openaiModel) {\n  process.env.OPENAI_MODEL = cfg.openaiModel;\n}\nif (cfg.anthropicModel) {\n  process.env.ANTHROPIC_MODEL = cfg.anthropicModel;\n}\n\n// Helper functions for provider status messages\nfunction hasProviderConflict(): boolean {\n  const hasAnthropic = Boolean(process.env.ANTHROPIC_API_KEY);\n  const hasOpenAI = Boolean(process.env.OPENAI_API_KEY);\n  const hasExplicitProvider =\n    cfg.agentProvider || process.env.EMBEDDED_AGENT_PROVIDER;\n  return hasAnthropic && hasOpenAI && !hasExplicitProvider;\n}\n\nfunction getConfiguredProvider(): string | undefined {\n  return (\n    cfg.agentProvider || process.env.EMBEDDED_AGENT_PROVIDER?.toLowerCase()\n  );\n}\n\nfunction hasProviderMismatch(): {\n  mismatch: boolean;\n  configured?: string;\n  availableKey?: string;\n} {\n  const configured = getConfiguredProvider();\n  if (!configured) return { mismatch: false };\n\n  const hasAnthropic = Boolean(process.env.ANTHROPIC_API_KEY);\n  const hasOpenAI = Boolean(process.env.OPENAI_API_KEY);\n\n  // Check if configured provider's key is missing but other key is present\n  if (configured === \"openai\" && !hasOpenAI && hasAnthropic) {\n    return {\n      mismatch: true,\n      configured: \"openai\",\n      availableKey: \"ANTHROPIC_API_KEY\",\n    };\n  }\n  if (configured === \"anthropic\" && !hasAnthropic && hasOpenAI) {\n    return {\n      mismatch: true,\n      configured: \"anthropic\",\n      availableKey: \"OPENAI_API_KEY\",\n    };\n  }\n\n  return { mismatch: false };\n}\n\nfunction getProviderSource(): string {\n  // Check CLI flag first (cli.agentProvider is only set by --agent-provider flag)\n  if (cli.agentProvider) return \"explicitly configured\";\n  // Then check env var (process.env takes precedence over cfg since cfg merges both)\n  if (process.env.EMBEDDED_AGENT_PROVIDER)\n    return \"from EMBEDDED_AGENT_PROVIDER\";\n  return \"auto-detected\";\n}\n\n// Check for LLM API keys and warn if none available\nconst resolvedProvider = getResolvedProviderType();\n\nif (!resolvedProvider) {\n  const mismatchInfo = hasProviderMismatch();\n  if (hasProviderConflict()) {\n    console.warn(\n      \"Warning: Both ANTHROPIC_API_KEY and OPENAI_API_KEY are set, but no provider is explicitly configured.\",\n    );\n    console.warn(\n      \"Please set EMBEDDED_AGENT_PROVIDER='openai' or 'anthropic' to specify which provider to use.\",\n    );\n    console.warn(\n      \"AI-powered search tools will be unavailable until a provider is selected.\",\n    );\n  } else if (mismatchInfo.mismatch) {\n    const expectedKey =\n      mismatchInfo.configured === \"openai\"\n        ? \"OPENAI_API_KEY\"\n        : \"ANTHROPIC_API_KEY\";\n    const configuredViaCliFlag = Boolean(cli.agentProvider);\n    const providerSetting = configuredViaCliFlag\n      ? `--agent-provider=${mismatchInfo.configured}`\n      : `EMBEDDED_AGENT_PROVIDER='${mismatchInfo.configured}'`;\n    const changeProviderHint = configuredViaCliFlag\n      ? \"Change --agent-provider to match your available API key\"\n      : \"Change EMBEDDED_AGENT_PROVIDER to match your available API key\";\n    console.warn(`Warning: ${providerSetting} but ${expectedKey} is not set.`);\n    console.warn(`Found ${mismatchInfo.availableKey} instead. Either:`);\n    console.warn(\n      `  - Set ${expectedKey} to use the ${mismatchInfo.configured} provider, or`,\n    );\n    console.warn(`  - ${changeProviderHint}`);\n    console.warn(\n      \"AI-powered search tools will be unavailable until this is resolved.\",\n    );\n  } else {\n    console.warn(\n      \"Warning: No LLM API key found (OPENAI_API_KEY or ANTHROPIC_API_KEY).\",\n    );\n    console.warn(\"The following AI-powered search tools will be unavailable:\");\n    console.warn(\n      \"  - search_events, search_issues, search_issue_events, use_sentry\",\n    );\n    console.warn(\n      \"Use list_issues and list_events for direct Sentry query syntax instead.\",\n    );\n  }\n  console.warn(\"\");\n} else {\n  const providerSource = getProviderSource();\n  console.warn(\n    `Using ${resolvedProvider} for AI-powered search tools (${providerSource}).`,\n  );\n  // Warn about auto-detection deprecation\n  if (providerSource === \"auto-detected\") {\n    console.warn(\n      \"Deprecation warning: Auto-detection of LLM provider is deprecated.\",\n    );\n    console.warn(\n      `Please set EMBEDDED_AGENT_PROVIDER='${resolvedProvider}' explicitly.`,\n    );\n    console.warn(\"Auto-detection will be removed in a future release.\");\n  }\n  console.warn(\"\");\n}\n\nSentry.init({\n  dsn: cfg.sentryDsn,\n  sendDefaultPii: true,\n  tracesSampleRate: 1,\n  beforeSend: sentryBeforeSend,\n  initialScope: {\n    tags: {\n      \"mcp.server_version\": LIB_VERSION,\n      \"mcp.transport\": \"stdio\",\n      \"mcp.agent_mode\": cli.agent ? \"true\" : \"false\",\n      \"mcp.experimental_mode\": cli.experimental ? \"true\" : \"false\",\n      \"sentry.host\": cfg.sentryHost,\n      \"mcp.mcp-url\": cfg.mcpUrl,\n    },\n  },\n  release: process.env.SENTRY_RELEASE,\n  integrations: [\n    Sentry.consoleLoggingIntegration(),\n    Sentry.zodErrorsIntegration(),\n    Sentry.vercelAIIntegration({\n      recordInputs: true,\n      recordOutputs: true,\n    }),\n  ],\n  environment:\n    process.env.SENTRY_ENVIRONMENT ??\n    (process.env.NODE_ENV !== \"production\" ? \"development\" : \"production\"),\n});\n\n// Log agent mode status\nif (cli.agent) {\n  console.warn(\"Agent mode enabled: Only use_sentry tool is available.\");\n  console.warn(\n    \"The use_sentry tool provides access to all Sentry operations through natural language.\",\n  );\n  console.warn(\"\");\n}\n\n// Log experimental mode status\nif (cli.experimental) {\n  console.warn(\"Experimental mode enabled: Experimental tools are available.\");\n  console.warn(\"\");\n}\n\nconst SENTRY_TIMEOUT = 5000; // 5 seconds\n\n// Graceful shutdown handlers\nasync function shutdown(signal: string) {\n  console.error(`${signal} received, shutting down...`);\n  await Sentry.flush(SENTRY_TIMEOUT);\n  process.exit(0);\n}\n\nprocess.on(\"SIGTERM\", () => shutdown(\"SIGTERM\"));\nprocess.on(\"SIGINT\", () => shutdown(\"SIGINT\"));\n\n// Uncaught error handlers\nprocess.on(\"uncaughtException\", async (error) => {\n  console.error(\"Uncaught exception:\", error);\n  Sentry.captureException(error);\n  await Sentry.flush(SENTRY_TIMEOUT);\n  process.exit(1);\n});\n\nprocess.on(\"unhandledRejection\", async (reason) => {\n  console.error(\"Unhandled rejection:\", reason);\n  Sentry.captureException(reason);\n  await Sentry.flush(SENTRY_TIMEOUT);\n  process.exit(1);\n});\n\n// Build context once for server configuration and runtime\nconst context = {\n  accessToken: cfg.accessToken,\n  grantedSkills: cfg.finalSkills,\n  constraints: {\n    organizationSlug: cfg.organizationSlug ?? null,\n    projectSlug: cfg.projectSlug ?? null,\n  },\n  sentryHost: cfg.sentryHost,\n  mcpUrl: cfg.mcpUrl,\n  openaiBaseUrl: cfg.openaiBaseUrl,\n  agentMode: cli.agent,\n  experimentalMode: cli.experimental,\n};\n\n// Build server with context to filter tools based on granted skills\n// Use agentMode when --agent flag is set (only exposes use_sentry tool)\n// Use experimentalMode when --experimental flag is set (includes experimental tools)\nconst server = buildServer({\n  context,\n  agentMode: cli.agent,\n  experimentalMode: cli.experimental,\n});\n\nstartStdio(server, context).catch(async (err) => {\n  console.error(\"Server error:\", err);\n  Sentry.captureException(err);\n  await Sentry.flush(SENTRY_TIMEOUT);\n  process.exit(1);\n});\n"],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+import { startStdio } from "./transports/stdio.js";
+import { buildUsage } from "./cli/usage.js";
+import { merge, parseArgv, parseEnv } from "./cli/parse.js";
+import { finalize } from "./cli/resolve.js";
+import { buildServer } from "@sentry/mcp-core/server";
+import * as Sentry from "@sentry/node";
+import { LIB_VERSION } from "@sentry/mcp-core/version";
+import { SKILLS } from "@sentry/mcp-core/skills";
+import { sentryBeforeSend } from "@sentry/mcp-core/telem/sentry";
+import { getResolvedProviderType, setAgentProvider, setProviderBaseUrls } from "@sentry/mcp-core/internal/agents/provider-factory";
+
+//#region src/index.ts
+/**
+* Main CLI entry point for the Sentry MCP server.
+*
+* Handles command-line argument parsing, environment configuration, Sentry
+* initialization, and starts the MCP server with stdio transport. Requires
+* a Sentry access token and optionally accepts host and DSN configuration.
+*
+* @example CLI Usage
+* ```bash
+* npx @sentry/mcp-server --access-token=TOKEN --host=sentry.io
+* npx @sentry/mcp-server --access-token=TOKEN --url=https://sentry.example.com
+* ```
+*/
+const packageName = "@sentry/mcp-server";
+const usageText = buildUsage(packageName, Object.keys(SKILLS));
+function die(message) {
+	console.error(message);
+	console.error(usageText);
+	process.exit(1);
+}
+const cli = parseArgv(process.argv.slice(2));
+if (cli.help) {
+	console.log(usageText);
+	process.exit(0);
+}
+if (cli.version) {
+	console.log(`${packageName} ${LIB_VERSION}`);
+	process.exit(0);
+}
+if (cli.unknownArgs.length > 0) {
+	console.error("Error: Invalid argument(s):", cli.unknownArgs.join(", "));
+	console.error(usageText);
+	process.exit(1);
+}
+const env = parseEnv(process.env);
+const cfg = (() => {
+	try {
+		return finalize(merge(cli, env));
+	} catch (err) {
+		die(err instanceof Error ? err.message : String(err));
+	}
+})();
+if (cfg.agentProvider) setAgentProvider(cfg.agentProvider);
+setProviderBaseUrls({
+	openaiBaseUrl: cfg.openaiBaseUrl,
+	anthropicBaseUrl: cfg.anthropicBaseUrl
+});
+if (cfg.openaiModel) process.env.OPENAI_MODEL = cfg.openaiModel;
+if (cfg.anthropicModel) process.env.ANTHROPIC_MODEL = cfg.anthropicModel;
+function hasProviderConflict() {
+	const hasAnthropic = Boolean(process.env.ANTHROPIC_API_KEY);
+	const hasOpenAI = Boolean(process.env.OPENAI_API_KEY);
+	const hasExplicitProvider = cfg.agentProvider || process.env.EMBEDDED_AGENT_PROVIDER;
+	return hasAnthropic && hasOpenAI && !hasExplicitProvider;
+}
+function getConfiguredProvider() {
+	return cfg.agentProvider || process.env.EMBEDDED_AGENT_PROVIDER?.toLowerCase();
+}
+function hasProviderMismatch() {
+	const configured = getConfiguredProvider();
+	if (!configured) return { mismatch: false };
+	const hasAnthropic = Boolean(process.env.ANTHROPIC_API_KEY);
+	const hasOpenAI = Boolean(process.env.OPENAI_API_KEY);
+	if (configured === "openai" && !hasOpenAI && hasAnthropic) return {
+		mismatch: true,
+		configured: "openai",
+		availableKey: "ANTHROPIC_API_KEY"
+	};
+	if (configured === "anthropic" && !hasAnthropic && hasOpenAI) return {
+		mismatch: true,
+		configured: "anthropic",
+		availableKey: "OPENAI_API_KEY"
+	};
+	return { mismatch: false };
+}
+function getProviderSource() {
+	if (cli.agentProvider) return "explicitly configured";
+	if (process.env.EMBEDDED_AGENT_PROVIDER) return "from EMBEDDED_AGENT_PROVIDER";
+	return "auto-detected";
+}
+const resolvedProvider = getResolvedProviderType();
+if (!resolvedProvider) {
+	const mismatchInfo = hasProviderMismatch();
+	if (hasProviderConflict()) {
+		console.warn("Warning: Both ANTHROPIC_API_KEY and OPENAI_API_KEY are set, but no provider is explicitly configured.");
+		console.warn("Please set EMBEDDED_AGENT_PROVIDER='openai' or 'anthropic' to specify which provider to use.");
+		console.warn("AI-powered search tools will be unavailable until a provider is selected.");
+	} else if (mismatchInfo.mismatch) {
+		const expectedKey = mismatchInfo.configured === "openai" ? "OPENAI_API_KEY" : "ANTHROPIC_API_KEY";
+		const configuredViaCliFlag = Boolean(cli.agentProvider);
+		const providerSetting = configuredViaCliFlag ? `--agent-provider=${mismatchInfo.configured}` : `EMBEDDED_AGENT_PROVIDER='${mismatchInfo.configured}'`;
+		const changeProviderHint = configuredViaCliFlag ? "Change --agent-provider to match your available API key" : "Change EMBEDDED_AGENT_PROVIDER to match your available API key";
+		console.warn(`Warning: ${providerSetting} but ${expectedKey} is not set.`);
+		console.warn(`Found ${mismatchInfo.availableKey} instead. Either:`);
+		console.warn(`  - Set ${expectedKey} to use the ${mismatchInfo.configured} provider, or`);
+		console.warn(`  - ${changeProviderHint}`);
+		console.warn("AI-powered search tools will be unavailable until this is resolved.");
+	} else {
+		console.warn("Warning: No LLM API key found (OPENAI_API_KEY or ANTHROPIC_API_KEY).");
+		console.warn("The following AI-powered search tools will be unavailable:");
+		console.warn("  - search_events, search_issues, search_issue_events, use_sentry");
+		console.warn("Use list_issues and list_events for direct Sentry query syntax instead.");
+	}
+	console.warn("");
+} else {
+	const providerSource = getProviderSource();
+	console.warn(`Using ${resolvedProvider} for AI-powered search tools (${providerSource}).`);
+	if (providerSource === "auto-detected") {
+		console.warn("Deprecation warning: Auto-detection of LLM provider is deprecated.");
+		console.warn(`Please set EMBEDDED_AGENT_PROVIDER='${resolvedProvider}' explicitly.`);
+		console.warn("Auto-detection will be removed in a future release.");
+	}
+	console.warn("");
+}
+Sentry.init({
+	dsn: cfg.sentryDsn,
+	sendDefaultPii: true,
+	tracesSampleRate: 1,
+	beforeSend: sentryBeforeSend,
+	initialScope: { tags: {
+		"mcp.server_version": LIB_VERSION,
+		"mcp.transport": "stdio",
+		"mcp.agent_mode": cli.agent ? "true" : "false",
+		"mcp.experimental_mode": cli.experimental ? "true" : "false",
+		"sentry.host": cfg.sentryHost,
+		"mcp.mcp-url": cfg.mcpUrl
+	} },
+	release: process.env.SENTRY_RELEASE,
+	integrations: [
+		Sentry.consoleLoggingIntegration(),
+		Sentry.zodErrorsIntegration(),
+		Sentry.vercelAIIntegration({
+			recordInputs: true,
+			recordOutputs: true
+		})
+	],
+	environment: process.env.SENTRY_ENVIRONMENT ?? (process.env.NODE_ENV !== "production" ? "development" : "production")
+});
+if (cli.agent) {
+	console.warn("Agent mode enabled: Only use_sentry tool is available.");
+	console.warn("The use_sentry tool provides access to all Sentry operations through natural language.");
+	console.warn("");
+}
+if (cli.experimental) {
+	console.warn("Experimental mode enabled: Experimental tools are available.");
+	console.warn("");
+}
+const SENTRY_TIMEOUT = 5e3;
+async function shutdown(signal) {
+	console.error(`${signal} received, shutting down...`);
+	await Sentry.flush(SENTRY_TIMEOUT);
+	process.exit(0);
+}
+process.on("SIGTERM", () => shutdown("SIGTERM"));
+process.on("SIGINT", () => shutdown("SIGINT"));
+process.on("uncaughtException", async (error) => {
+	console.error("Uncaught exception:", error);
+	Sentry.captureException(error);
+	await Sentry.flush(SENTRY_TIMEOUT);
+	process.exit(1);
+});
+process.on("unhandledRejection", async (reason) => {
+	console.error("Unhandled rejection:", reason);
+	Sentry.captureException(reason);
+	await Sentry.flush(SENTRY_TIMEOUT);
+	process.exit(1);
+});
+const context = {
+	accessToken: cfg.accessToken,
+	grantedSkills: cfg.finalSkills,
+	constraints: {
+		organizationSlug: cfg.organizationSlug ?? null,
+		projectSlug: cfg.projectSlug ?? null
+	},
+	sentryHost: cfg.sentryHost,
+	mcpUrl: cfg.mcpUrl,
+	openaiBaseUrl: cfg.openaiBaseUrl,
+	agentMode: cli.agent,
+	experimentalMode: cli.experimental
+};
+startStdio(buildServer({
+	context,
+	agentMode: cli.agent,
+	experimentalMode: cli.experimental
+}), context).catch(async (err) => {
+	console.error("Server error:", err);
+	Sentry.captureException(err);
+	await Sentry.flush(SENTRY_TIMEOUT);
+	process.exit(1);
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * Main CLI entry point for the Sentry MCP server.\n *\n * Handles command-line argument parsing, environment configuration, Sentry\n * initialization, and starts the MCP server with stdio transport. Requires\n * a Sentry access token and optionally accepts host and DSN configuration.\n *\n * @example CLI Usage\n * ```bash\n * npx @sentry/mcp-server --access-token=TOKEN --host=sentry.io\n * npx @sentry/mcp-server --access-token=TOKEN --url=https://sentry.example.com\n * ```\n */\n\nimport { buildServer } from \"@sentry/mcp-core/server\";\nimport { startStdio } from \"./transports/stdio\";\nimport * as Sentry from \"@sentry/node\";\nimport { LIB_VERSION } from \"@sentry/mcp-core/version\";\nimport { buildUsage } from \"./cli/usage\";\nimport { parseArgv, parseEnv, merge } from \"./cli/parse\";\nimport { finalize } from \"./cli/resolve\";\nimport { sentryBeforeSend } from \"@sentry/mcp-core/telem/sentry\";\nimport { SKILLS } from \"@sentry/mcp-core/skills\";\nimport {\n  setAgentProvider,\n  setProviderBaseUrls,\n  getResolvedProviderType,\n} from \"@sentry/mcp-core/internal/agents/provider-factory\";\n\nconst packageName = \"@sentry/mcp-server\";\nconst allSkills = Object.keys(SKILLS) as ReadonlyArray<\n  (typeof SKILLS)[keyof typeof SKILLS][\"id\"]\n>;\nconst usageText = buildUsage(packageName, allSkills);\n\nfunction die(message: string): never {\n  console.error(message);\n  console.error(usageText);\n  process.exit(1);\n}\nconst cli = parseArgv(process.argv.slice(2));\nif (cli.help) {\n  console.log(usageText);\n  process.exit(0);\n}\nif (cli.version) {\n  console.log(`${packageName} ${LIB_VERSION}`);\n  process.exit(0);\n}\nif (cli.unknownArgs.length > 0) {\n  console.error(\"Error: Invalid argument(s):\", cli.unknownArgs.join(\", \"));\n  console.error(usageText);\n  process.exit(1);\n}\n\nconst env = parseEnv(process.env);\nconst cfg = (() => {\n  try {\n    return finalize(merge(cli, env));\n  } catch (err) {\n    die(err instanceof Error ? err.message : String(err));\n  }\n})();\n\n// Configure embedded agent provider\nif (cfg.agentProvider) {\n  setAgentProvider(cfg.agentProvider);\n}\nsetProviderBaseUrls({\n  openaiBaseUrl: cfg.openaiBaseUrl,\n  anthropicBaseUrl: cfg.anthropicBaseUrl,\n});\nif (cfg.openaiModel) {\n  process.env.OPENAI_MODEL = cfg.openaiModel;\n}\nif (cfg.anthropicModel) {\n  process.env.ANTHROPIC_MODEL = cfg.anthropicModel;\n}\n\n// Helper functions for provider status messages\nfunction hasProviderConflict(): boolean {\n  const hasAnthropic = Boolean(process.env.ANTHROPIC_API_KEY);\n  const hasOpenAI = Boolean(process.env.OPENAI_API_KEY);\n  const hasExplicitProvider =\n    cfg.agentProvider || process.env.EMBEDDED_AGENT_PROVIDER;\n  return hasAnthropic && hasOpenAI && !hasExplicitProvider;\n}\n\nfunction getConfiguredProvider(): string | undefined {\n  return (\n    cfg.agentProvider || process.env.EMBEDDED_AGENT_PROVIDER?.toLowerCase()\n  );\n}\n\nfunction hasProviderMismatch(): {\n  mismatch: boolean;\n  configured?: string;\n  availableKey?: string;\n} {\n  const configured = getConfiguredProvider();\n  if (!configured) return { mismatch: false };\n\n  const hasAnthropic = Boolean(process.env.ANTHROPIC_API_KEY);\n  const hasOpenAI = Boolean(process.env.OPENAI_API_KEY);\n\n  // Check if configured provider's key is missing but other key is present\n  if (configured === \"openai\" && !hasOpenAI && hasAnthropic) {\n    return {\n      mismatch: true,\n      configured: \"openai\",\n      availableKey: \"ANTHROPIC_API_KEY\",\n    };\n  }\n  if (configured === \"anthropic\" && !hasAnthropic && hasOpenAI) {\n    return {\n      mismatch: true,\n      configured: \"anthropic\",\n      availableKey: \"OPENAI_API_KEY\",\n    };\n  }\n\n  return { mismatch: false };\n}\n\nfunction getProviderSource(): string {\n  // Check CLI flag first (cli.agentProvider is only set by --agent-provider flag)\n  if (cli.agentProvider) return \"explicitly configured\";\n  // Then check env var (process.env takes precedence over cfg since cfg merges both)\n  if (process.env.EMBEDDED_AGENT_PROVIDER)\n    return \"from EMBEDDED_AGENT_PROVIDER\";\n  return \"auto-detected\";\n}\n\n// Check for LLM API keys and warn if none available\nconst resolvedProvider = getResolvedProviderType();\n\nif (!resolvedProvider) {\n  const mismatchInfo = hasProviderMismatch();\n  if (hasProviderConflict()) {\n    console.warn(\n      \"Warning: Both ANTHROPIC_API_KEY and OPENAI_API_KEY are set, but no provider is explicitly configured.\",\n    );\n    console.warn(\n      \"Please set EMBEDDED_AGENT_PROVIDER='openai' or 'anthropic' to specify which provider to use.\",\n    );\n    console.warn(\n      \"AI-powered search tools will be unavailable until a provider is selected.\",\n    );\n  } else if (mismatchInfo.mismatch) {\n    const expectedKey =\n      mismatchInfo.configured === \"openai\"\n        ? \"OPENAI_API_KEY\"\n        : \"ANTHROPIC_API_KEY\";\n    const configuredViaCliFlag = Boolean(cli.agentProvider);\n    const providerSetting = configuredViaCliFlag\n      ? `--agent-provider=${mismatchInfo.configured}`\n      : `EMBEDDED_AGENT_PROVIDER='${mismatchInfo.configured}'`;\n    const changeProviderHint = configuredViaCliFlag\n      ? \"Change --agent-provider to match your available API key\"\n      : \"Change EMBEDDED_AGENT_PROVIDER to match your available API key\";\n    console.warn(`Warning: ${providerSetting} but ${expectedKey} is not set.`);\n    console.warn(`Found ${mismatchInfo.availableKey} instead. Either:`);\n    console.warn(\n      `  - Set ${expectedKey} to use the ${mismatchInfo.configured} provider, or`,\n    );\n    console.warn(`  - ${changeProviderHint}`);\n    console.warn(\n      \"AI-powered search tools will be unavailable until this is resolved.\",\n    );\n  } else {\n    console.warn(\n      \"Warning: No LLM API key found (OPENAI_API_KEY or ANTHROPIC_API_KEY).\",\n    );\n    console.warn(\"The following AI-powered search tools will be unavailable:\");\n    console.warn(\n      \"  - search_events, search_issues, search_issue_events, use_sentry\",\n    );\n    console.warn(\n      \"Use list_issues and list_events for direct Sentry query syntax instead.\",\n    );\n  }\n  console.warn(\"\");\n} else {\n  const providerSource = getProviderSource();\n  console.warn(\n    `Using ${resolvedProvider} for AI-powered search tools (${providerSource}).`,\n  );\n  // Warn about auto-detection deprecation\n  if (providerSource === \"auto-detected\") {\n    console.warn(\n      \"Deprecation warning: Auto-detection of LLM provider is deprecated.\",\n    );\n    console.warn(\n      `Please set EMBEDDED_AGENT_PROVIDER='${resolvedProvider}' explicitly.`,\n    );\n    console.warn(\"Auto-detection will be removed in a future release.\");\n  }\n  console.warn(\"\");\n}\n\nSentry.init({\n  dsn: cfg.sentryDsn,\n  sendDefaultPii: true,\n  tracesSampleRate: 1,\n  beforeSend: sentryBeforeSend,\n  initialScope: {\n    tags: {\n      \"mcp.server_version\": LIB_VERSION,\n      \"mcp.transport\": \"stdio\",\n      \"mcp.agent_mode\": cli.agent ? \"true\" : \"false\",\n      \"mcp.experimental_mode\": cli.experimental ? \"true\" : \"false\",\n      \"sentry.host\": cfg.sentryHost,\n      \"mcp.mcp-url\": cfg.mcpUrl,\n    },\n  },\n  release: process.env.SENTRY_RELEASE,\n  integrations: [\n    Sentry.consoleLoggingIntegration(),\n    Sentry.zodErrorsIntegration(),\n    Sentry.vercelAIIntegration({\n      recordInputs: true,\n      recordOutputs: true,\n    }),\n  ],\n  environment:\n    process.env.SENTRY_ENVIRONMENT ??\n    (process.env.NODE_ENV !== \"production\" ? \"development\" : \"production\"),\n});\n\n// Log agent mode status\nif (cli.agent) {\n  console.warn(\"Agent mode enabled: Only use_sentry tool is available.\");\n  console.warn(\n    \"The use_sentry tool provides access to all Sentry operations through natural language.\",\n  );\n  console.warn(\"\");\n}\n\n// Log experimental mode status\nif (cli.experimental) {\n  console.warn(\"Experimental mode enabled: Experimental tools are available.\");\n  console.warn(\"\");\n}\n\nconst SENTRY_TIMEOUT = 5000; // 5 seconds\n\n// Graceful shutdown handlers\nasync function shutdown(signal: string) {\n  console.error(`${signal} received, shutting down...`);\n  await Sentry.flush(SENTRY_TIMEOUT);\n  process.exit(0);\n}\n\nprocess.on(\"SIGTERM\", () => shutdown(\"SIGTERM\"));\nprocess.on(\"SIGINT\", () => shutdown(\"SIGINT\"));\n\n// Uncaught error handlers\nprocess.on(\"uncaughtException\", async (error) => {\n  console.error(\"Uncaught exception:\", error);\n  Sentry.captureException(error);\n  await Sentry.flush(SENTRY_TIMEOUT);\n  process.exit(1);\n});\n\nprocess.on(\"unhandledRejection\", async (reason) => {\n  console.error(\"Unhandled rejection:\", reason);\n  Sentry.captureException(reason);\n  await Sentry.flush(SENTRY_TIMEOUT);\n  process.exit(1);\n});\n\n// Build context once for server configuration and runtime\nconst context = {\n  accessToken: cfg.accessToken,\n  grantedSkills: cfg.finalSkills,\n  constraints: {\n    organizationSlug: cfg.organizationSlug ?? null,\n    projectSlug: cfg.projectSlug ?? null,\n  },\n  sentryHost: cfg.sentryHost,\n  mcpUrl: cfg.mcpUrl,\n  openaiBaseUrl: cfg.openaiBaseUrl,\n  agentMode: cli.agent,\n  experimentalMode: cli.experimental,\n};\n\n// Build server with context to filter tools based on granted skills\n// Use agentMode when --agent flag is set (only exposes use_sentry tool)\n// Use experimentalMode when --experimental flag is set (includes experimental tools)\nconst server = buildServer({\n  context,\n  agentMode: cli.agent,\n  experimentalMode: cli.experimental,\n});\n\nstartStdio(server, context).catch(async (err) => {\n  console.error(\"Server error:\", err);\n  Sentry.captureException(err);\n  await Sentry.flush(SENTRY_TIMEOUT);\n  process.exit(1);\n});\n"],"mappings":"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"}

package/dist/transports/stdio-DVcJU1wB.d.ts

@@ -0,0 +1,37 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ServerContext } from "@sentry/mcp-core/types";
+
+//#region src/transports/stdio.d.ts
+
+/**
+ * Starts the MCP server with stdio transport and telemetry.
+ *
+ * Connects the server using stdio transport for process-based communication.
+ * Context is already captured in tool handler closures during buildServer().
+ * All operations are wrapped in Sentry tracing for observability.
+ *
+ * @param server - Configured and instrumented MCP server instance (with context in closures)
+ * @param context - Server context with authentication and configuration (for telemetry attributes)
+ *
+ * @example CLI Integration
+ * ```typescript
+ * import { buildServer } from "./server.js";
+ * import { startStdio } from "./transports/stdio.js";
+ *
+ * const context = {
+ *   accessToken: userToken,
+ *   sentryHost: "sentry.io",
+ *   userId: "user-123",
+ *   clientId: "cursor-ide",
+ *   constraints: {}
+ * };
+ *
+ * const server = buildServer({ context }); // Context captured in closures
+ * await startStdio(server, context);
+ * ```
+ */
+declare function startStdio(server: McpServer, context: ServerContext): Promise<void>;
+//# sourceMappingURL=stdio.d.ts.map
+//#endregion
+export { startStdio };
+//# sourceMappingURL=stdio-DVcJU1wB.d.ts.map

package/dist/transports/stdio-DVcJU1wB.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-DVcJU1wB.d.ts","names":[],"sources":["../../src/transports/stdio.ts"],"sourcesContent":[],"mappings":";;;;;;;AAqDA;;;;;;;;;;;;;;;;;;;;;;;;;iBAAsB,UAAA,SAAmB,oBAAoB,gBAAa"}