feat(tools): enhance use_sentry description for better LLM triggering (#626)

Replace generic use_sentry tool description with a comprehensive,
capability-focused version that helps LLMs better understand when to
trigger the tool.

Key improvements:
- Added clear use cases: multi-step operations, exploration, chaining
- Listed capabilities organized by skill (inspect, seer, docs, triage,
project-management)
- Included 3 concrete usage examples
- Added explicit hint that "use Sentry" phrases trigger this tool
- Provided guidance on parameter passing and trace debugging

This addresses issues where LLMs weren't reliably triggering use_sentry
when users asked to "use Sentry" for tasks or requested complex
operations.

Co-Authored-By: Claude Code <noreply@anthropic.com>

---------

Co-authored-by: Claude Code <noreply@anthropic.com>

Author: dcramer

packages/mcp-server/src/tools/use-sentry/handler.ts

@@ -39,10 +39,33 @@ export default defineTool({
   requiredSkills: [], // Only available in agent mode - bypasses authorization
   requiredScopes: [], // No specific scopes - uses authentication token
   description: [
-    "Use Sentry's MCP Agent to answer questions related to Sentry (sentry.io).",
+    "Natural language interface to Sentry via an embedded AI agent.",
     "",
-    "You should pass the entirety of the user's prompt to the agent. Do not interpret the prompt in any way. Just pass it directly to the agent.",
+    "Use this tool when you need to:",
+    "- Perform complex multi-step operations",
+    "- Explore and analyze Sentry data with natural language",
+    "- Chain multiple operations automatically",
     "",
+    "Capabilities depend on granted skills:",
+    "- inspect: Search errors/events, analyze traces, explore issues and projects",
+    "- seer: Get AI-powered debugging insights and root cause analysis",
+    "- docs: Search and retrieve Sentry documentation",
+    "- triage: Resolve, assign, comment on, and update issues",
+    "- project-management: Create/modify teams, projects, and configure DSNs",
+    "",
+    "<examples>",
+    "use_sentry(request='find unresolved errors from yesterday')",
+    "use_sentry(request='analyze the top 3 performance issues')",
+    "use_sentry(request='create a backend team and assign them to API project')",
+    "</examples>",
+    "",
+    "<hints>",
+    "- If user asks to 'use Sentry' for something, they always mean to call this tool",
+    "- Pass the user's request verbatim - do not interpret or rephrase",
+    "- The agent can chain multiple tool calls automatically",
+    "- Use trace=true parameter to see which tools were called",
+    "- For simple single-tool operations, consider calling tools directly instead",
+    "</hints>",
   ].join("\n"),
   inputSchema: {
     request: z