Adjusting prompts and tool descriptions

Author: maxl0rd

src/mcp/README.md

@@ -6,7 +6,7 @@ export const connect = prompt(
   {
     name: "connect",
     omitPrefix: false,
-    description: "Access a Firebase application's Crashlytics data.",
+    description: "Use this command to access a Firebase application's Crashlytics data.",
     annotations: {
       title: "Access Crashlytics data",
     },

src/mcp/prompts/crashlytics/connect.ts

@@ -3,7 +3,7 @@ import { resource } from "../../resource";
 export const RESOURCE_CONTENT = `
 ### Instructions for Working with Firebase Crashlytics Tools
 
-Only ask the user one question at a time. Do not proceed without user instructions. Upon receiving user instructions, refer to the relevant resources for guidance.
+When working interactively with a user, only ask the one question at a time. Do not proceed without user instructions. Upon receiving user instructions, refer to the relevant resources for guidance.
 
 Use the \`firebase_read_resources\` tool to access the following guides.
 
@@ -16,22 +16,26 @@ Use the \`firebase_read_resources\` tool to access the following guides.
   3. [Firebase Crashlytics Issues Guide](firebase://guides/crashlytics/issues)
      This guide details how to work with issues within Crashlytics. The agent should read this guide before prioritizing issues or presenting issue data to the user.
 
-  4. [Investigating Crashlytics Issues](firebase://guides/crashlytics/investigations)
+  4. [Investigating Crashlytics Issues Guide](firebase://guides/crashlytics/investigations)
      This guide provides instructions on investigating the root causes of crashes and exceptions reported in Crashlytics issues.
 
-### Check That You Are Connected
+### How to Check That You Are Connected
 
 Verify that you can read the app's Crashlytics data by getting the topVersions report. This report will tell you which app versions have the most events.
-  a. Use the firebase://guides/app_id if you need to find the app_id.
+  a. Read the firebase://guides/app_id if you need to find the app_id.
   b. Call the \`crashlytics_get_report\` tool to read the \`topVersions\` report.
-  c. If you haven't read the reports guide, then the tool will include it in the response. This is OK. Simply call the tool again.
-  d. Help the user resolve any issues that arise when trying to connect.
+  c. Help the user resolve any issues that arise when trying to connect.
 
-After confirming you can access Crashlytics, ask the user what they would like help with. Your capabilities include:
+After confirming that you can access Crashlytics, ask the user what they would like help with. Your capabilities include:
 
-  - Reading Crashlytics reports to prioritize or find important issues. Before fetching issues or reports, you MUST read both the firebase://guides/crashlytics/reports and firebase://guides/crashlytics/issues guides to know how to best help users with this.
-  - Investigating bug reports using Crashlytics event data. Before attempting to investigate an individual issue, you MUST read the firebase://guides/crashlytics/investigations guide to know how to best help users with this.
-  - Proposing code changes to resolve identified bugs.
+  - *Reading Crashlytics reports to prioritize or find important issues.*
+    Before fetching reports, read the critical instructions for the \`crashlytics_get_report\` tool in the [Firebase Crashlytics Reports Guide](firebase://guides/crashlytics/reports).
+
+  - *Investigating bug reports using Crashlytics event data.* 
+    Before attempting to investigate an individual issue, read the [Investigating Crashlytics Issues Guide](firebase://guides/crashlytics/investigations) to understand the best practices for debugging issues.
+
+  - *Proposing code changes to resolve identified bugs.*
+    
 `.trim();
 
 export const crashlytics_connect = resource(

src/mcp/resources/guides/crashlytics_connect.ts

@@ -5,7 +5,7 @@ const RESOURCE_CONTENT = `
 
 When displaying a list of issues, use the following format:
 
-  1. Issue <issue id>
+  1. Issue <full issue id>
     * <the issue title>
     * <the issue subtitle>
     * **Description:** <a discription of the issue based on information from the tool response>

src/mcp/resources/guides/crashlytics_issues.ts

@@ -88,6 +88,15 @@ When setting report filters adhere to the following instructions.
   * Report responses grouped by issue will include a sample event URI. Use the "crashlytics_batch_get_events" tool to fetch the complete record for any sample event.
   
   * When investigating an issue, use the appropriate top devices and top operating systems reports to understand what systems are impacted by the problem. Pass the "issueId" in the filter to narrow any report to a specific issue.
+
+### How to Display Issues
+
+When displaying a list of issues, use the following format:
+
+  1. Issue <full issue id>
+    * <the issue title>
+    * <the issue subtitle>
+    * **Description:** <a discription of the issue based on information from the tool response>
 `.trim();
 
 export const crashlytics_reports = resource(

src/mcp/resources/guides/crashlytics_reports.ts

@@ -40,11 +40,7 @@ export const get_report = tool(
   {
     name: "get_report",
     description:
-      `**REQUIRED PREREQUISITE:** READ firebase://guides/app_id, firebase://guides/crashlytics/reports, and firebase://guides/crashlytics/issues.
-      **DO NOT FETCH DATA FIRST. IT WILL CAUSE ERRORS AND WASTE TOKENS AND TIME. READING THE GUIDES IS THE MOST EFFICIENT WAY TO GET THE ANSWERS YOU WANT.**
-      AGENTS MUST READ these guides to fetch, format, and interpret report results or TOOL CALLS WILL FAIL.
-
-      Use this to request numerical reports from Crashlytics.
+      `Use this to request numerical reports from Crashlytics. The result aggregates the sum of events and impacted users, grouped by a dimension appropriate for that report. Agents must read the [Firebase Crashlytics Reports Guide](firebase://guides/crashlytics/reports) using the \`firebase_read_resources\` tool before calling to understand criticial prerequisites for requesting reports and how to interpret the results.
     `.trim(),
     inputSchema: ReportInputSchema,
     annotations: {