get_trigger

Instructions

Implementation Reference

• src/tools/get-trigger.ts:58-113 (handler)

  Handler function for the get_trigger tool. Validates required parameters (environment, dataset, triggerId), fetches the trigger data via api.getTrigger, simplifies the response structure (including recipients), formats it as JSON text content with metadata (status), and handles errors.

  handler: async ({ environment, dataset, triggerId }: { environment: string; dataset: string; triggerId: string }) => {
    // Validate input parameters
    if (!environment) {
      return handleToolError(new Error("environment parameter is required"), "get_trigger");
    }
    if (!dataset) {
      return handleToolError(new Error("dataset parameter is required"), "get_trigger");
    }
    if (!triggerId) {
      return handleToolError(new Error("triggerId parameter is required"), "get_trigger");
    }
  
    try {
      // Fetch trigger details from the API
      const trigger = await api.getTrigger(environment, dataset, triggerId);
      
      // Simplify the response to reduce context window usage
      const simplifiedTrigger: SimplifiedTriggerDetails = {
        id: trigger.id,
        name: trigger.name,
        description: trigger.description || '',
        threshold: {
          op: trigger.threshold.op,
          value: trigger.threshold.value,
        },
        frequency: trigger.frequency,
        alert_type: trigger.alert_type,
        triggered: trigger.triggered,
        disabled: trigger.disabled,
        recipients: trigger.recipients.map(r => ({
          type: r.type,
          target: r.target,
        })),
        evaluation_schedule_type: trigger.evaluation_schedule_type,
        created_at: trigger.created_at,
        updated_at: trigger.updated_at,
      };
      
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(simplifiedTrigger, null, 2),
          },
        ],
        metadata: {
          triggerId,
          dataset,
          environment,
          status: trigger.triggered ? "TRIGGERED" : trigger.disabled ? "DISABLED" : "ACTIVE"
        }
      };
    } catch (error) {
      return handleToolError(error, "get_trigger");
    }
  }

• src/tools/get-trigger.ts:44-48 (schema)

  Zod schema defining the input parameters for the get_trigger tool: environment (string), dataset (string), triggerId (string).

  schema: {
    environment: z.string().describe("The Honeycomb environment"),
    dataset: z.string().describe("The dataset containing the trigger"),
    triggerId: z.string().describe("The ID of the trigger to retrieve"),
  },

• src/tools/index.ts:49-52 (registration)

  Registration of the get_trigger tool: imports createGetTriggerTool and adds the tool instance to the array of tools registered with the MCP server.

  // Trigger tools
  createListTriggersTool(api),
  createGetTriggerTool(api),

• src/tools/get-trigger.ts:16-32 (helper)

  Helper interface defining the simplified trigger data structure used in the tool's response to reduce context window usage.

  interface SimplifiedTriggerDetails {
    id: string;
    name: string;
    description: string;
    threshold: {
      op: string;
      value: number;
    };
    frequency: number;
    alert_type?: string;
    triggered: boolean;
    disabled: boolean;
    recipients: SimplifiedRecipient[];
    evaluation_schedule_type?: string;
    created_at: string;
    updated_at: string;
  }

• src/tools/get-trigger.ts:8-11 (helper)

  Helper interface for simplified recipient objects in triggers.

  interface SimplifiedRecipient {
    type: string;
    target?: string;
  }