@metronome/mcp 0.1.0-beta.11 → 0.1.0

package/src/compat.ts

@@ -19,6 +19,46 @@ export const defaultClientCapabilities: ClientCapabilities = {
   toolNameLength: undefined,
 };
 
+export type ClientType = 'openai-agents' | 'claude' | 'claude-code' | 'cursor';
+
+// Client presets for compatibility
+// Note that these could change over time as models get better, so this is
+// a best effort.
+export const knownClients: Record<ClientType, ClientCapabilities> = {
+  'openai-agents': {
+    topLevelUnions: false,
+    validJson: true,
+    refs: true,
+    unions: true,
+    formats: true,
+    toolNameLength: undefined,
+  },
+  claude: {
+    topLevelUnions: true,
+    validJson: false,
+    refs: true,
+    unions: true,
+    formats: true,
+    toolNameLength: undefined,
+  },
+  'claude-code': {
+    topLevelUnions: false,
+    validJson: true,
+    refs: true,
+    unions: true,
+    formats: true,
+    toolNameLength: undefined,
+  },
+  cursor: {
+    topLevelUnions: false,
+    validJson: true,
+    refs: false,
+    unions: false,
+    formats: false,
+    toolNameLength: 50,
+  },
+};
+
 /**
  * Attempts to parse strings into JSON objects
  */

package/src/dynamic-tools.ts

@@ -1,5 +1,5 @@
 import Metronome from '@metronome/sdk';
-import { Endpoint } from './tools';
+import { Endpoint, asTextContentResult, ToolCallResult } from './tools/types';
 import { zodToJsonSchema } from 'zod-to-json-schema';
 import { z } from 'zod';
 import { Cabidela } from '@cloudflare/cabidela';
@@ -41,7 +41,10 @@ export function dynamicTools(endpoints: Endpoint[]): Endpoint[] {
       description: 'List or search for all endpoints in the Metronome Node API',
       inputSchema: zodToInputSchema(listEndpointsSchema),
     },
-    handler: async (client: Metronome, args: Record<string, unknown> | undefined) => {
+    handler: async (
+      client: Metronome,
+      args: Record<string, unknown> | undefined,
+    ): Promise<ToolCallResult> => {
       const query = args && listEndpointsSchema.parse(args).search_query?.trim();
 
       const filteredEndpoints =
@@ -58,7 +61,7 @@ export function dynamicTools(endpoints: Endpoint[]): Endpoint[] {
           })
         : endpoints;
 
-      return {
+      return asTextContentResult({
         tools: filteredEndpoints.map(({ tool, metadata }) => ({
           name: tool.name,
           description: tool.description,
@@ -66,7 +69,7 @@ export function dynamicTools(endpoints: Endpoint[]): Endpoint[] {
           operation: metadata.operation,
           tags: metadata.tags,
         })),
-      };
+      });
     },
   };
 
@@ -95,7 +98,7 @@ export function dynamicTools(endpoints: Endpoint[]): Endpoint[] {
       if (!endpoint) {
         throw new Error(`Endpoint ${endpointName} not found`);
       }
-      return endpoint.tool;
+      return asTextContentResult(endpoint.tool);
     },
   };
 
@@ -120,7 +123,10 @@ export function dynamicTools(endpoints: Endpoint[]): Endpoint[] {
         'Invoke an endpoint in the Metronome Node API. Note: use the `list_api_endpoints` tool to get the list of endpoints and `get_api_endpoint_schema` tool to get the schema for an endpoint.',
       inputSchema: zodToInputSchema(invokeEndpointSchema),
     },
-    handler: async (client: Metronome, args: Record<string, unknown> | undefined) => {
+    handler: async (
+      client: Metronome,
+      args: Record<string, unknown> | undefined,
+    ): Promise<ToolCallResult> => {
       if (!args) {
         throw new Error('No endpoint provided');
       }
@@ -145,7 +151,7 @@ export function dynamicTools(endpoints: Endpoint[]): Endpoint[] {
         throw new Error(`Invalid arguments for endpoint ${endpoint_name}:\n${error}`);
       }
 
-      return endpoint.handler(client, endpointArgs);
+      return await endpoint.handler(client, endpointArgs);
     },
   };
 

package/src/filtering.ts

@@ -0,0 +1,15 @@
+// @ts-nocheck
+import initJq from 'jq-web';
+
+export async function maybeFilter(args: Record<string, unknown> | undefined, response: any): Promise<any> {
+  const jqFilter = args?.['jq_filter'];
+  if (jqFilter && typeof jqFilter === 'string') {
+    return await jq(response, jqFilter);
+  } else {
+    return response;
+  }
+}
+
+async function jq(json: any, jqFilter: string) {
+  return (await initJq).json(json, jqFilter);
+}

package/src/index.ts

@@ -1,7 +1,9 @@
+#!/usr/bin/env node
+
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { init, selectTools, server } from './server';
 import { Endpoint, endpoints } from './tools';
-import { ParsedOptions, parseOptions } from './options';
+import { McpOptions, parseOptions } from './options';
 
 async function main() {
   const options = parseOptionsOrError();
@@ -41,7 +43,7 @@ function parseOptionsOrError() {
   }
 }
 
-function selectToolsOrError(endpoints: Endpoint[], options: ParsedOptions) {
+function selectToolsOrError(endpoints: Endpoint[], options: McpOptions) {
   try {
     const includedTools = selectTools(endpoints, options);
     if (includedTools.length === 0) {

package/src/options.ts

@@ -1,55 +1,19 @@
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
 import { endpoints, Filter } from './tools';
-import { ClientCapabilities } from './compat';
+import { ClientCapabilities, knownClients, ClientType } from './compat';
 
-type ClientType = 'openai-agents' | 'claude' | 'claude-code' | 'cursor';
-
-// Client presets for compatibility
-// Note that these could change over time as models get better, so this is
-// a best effort.
-const CLIENT_PRESETS: Record<ClientType, ClientCapabilities> = {
-  'openai-agents': {
-    topLevelUnions: false,
-    validJson: true,
-    refs: true,
-    unions: true,
-    formats: true,
-    toolNameLength: undefined,
-  },
-  claude: {
-    topLevelUnions: true,
-    validJson: false,
-    refs: true,
-    unions: true,
-    formats: true,
-    toolNameLength: undefined,
-  },
-  'claude-code': {
-    topLevelUnions: false,
-    validJson: true,
-    refs: true,
-    unions: true,
-    formats: true,
-    toolNameLength: undefined,
-  },
-  cursor: {
-    topLevelUnions: false,
-    validJson: true,
-    refs: false,
-    unions: false,
-    formats: false,
-    toolNameLength: 50,
-  },
+export type CLIOptions = McpOptions & {
+  list: boolean;
 };
 
-export interface ParsedOptions {
+export type McpOptions = {
+  client: ClientType | undefined;
   includeDynamicTools: boolean | undefined;
   includeAllTools: boolean | undefined;
   filters: Filter[];
-  capabilities: ClientCapabilities;
-  list: boolean;
-}
+  capabilities?: Partial<ClientCapabilities>;
+};
 
 const CAPABILITY_CHOICES = [
   'top-level-unions',
@@ -80,7 +44,7 @@ function parseCapabilityValue(cap: string): { name: Capability; value?: number }
   return { name: cap as Capability };
 }
 
-export function parseOptions(): ParsedOptions {
+export function parseOptions(): CLIOptions {
   const opts = yargs(hideBin(process.argv))
     .option('tools', {
       type: 'string',
@@ -141,7 +105,7 @@ export function parseOptions(): ParsedOptions {
     })
     .option('client', {
       type: 'string',
-      choices: Object.keys(CLIENT_PRESETS),
+      choices: Object.keys(knownClients),
       description: 'Specify the MCP client being used',
     })
     .option('capability', {
@@ -229,14 +193,6 @@ export function parseOptions(): ParsedOptions {
     toolNameLength: undefined,
   };
 
-  // Apply client preset if specified
-  if (typeof argv.client === 'string') {
-    const clientKey = argv.client as ClientType;
-    if (CLIENT_PRESETS[clientKey]) {
-      Object.assign(clientCapabilities, CLIENT_PRESETS[clientKey]);
-    }
-  }
-
   // Apply individual capability overrides
   if (Array.isArray(argv.capability)) {
     for (const cap of argv.capability) {
@@ -282,7 +238,9 @@ export function parseOptions(): ParsedOptions {
   const includeAllTools =
     explicitTools ? argv.tools?.includes('all') && !argv.noTools?.includes('all') : undefined;
 
+  const client = argv.client as ClientType;
   return {
+    client: client && knownClients[client] ? client : undefined,
     includeDynamicTools,
     includeAllTools,
     filters,
@@ -323,7 +281,7 @@ Client Presets (--client):
 Presets like '--client=openai-agents' or '--client=cursor' automatically configure these capabilities based on current known limitations of those clients, simplifying setup.
 
 Current presets:
-${JSON.stringify(CLIENT_PRESETS, null, 2)}
+${JSON.stringify(knownClients, null, 2)}
   `;
 }
 

package/src/server.ts

@@ -4,34 +4,52 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { Endpoint, endpoints, HandlerFunction, query } from './tools';
 import { CallToolRequestSchema, ListToolsRequestSchema, Tool } from '@modelcontextprotocol/sdk/types.js';
+import { ClientOptions } from '@metronome/sdk';
 import Metronome from '@metronome/sdk';
 import {
   applyCompatibilityTransformations,
   ClientCapabilities,
   defaultClientCapabilities,
+  knownClients,
   parseEmbeddedJSON,
 } from './compat';
 import { dynamicTools } from './dynamic-tools';
-import { ParsedOptions } from './options';
+import { McpOptions } from './options';
+
+export { McpOptions } from './options';
+export { ClientType } from './compat';
+export { Filter } from './tools';
+export { ClientOptions } from '@metronome/sdk';
 export { endpoints } from './tools';
 
 // Create server instance
 export const server = new McpServer(
   {
     name: 'metronome_sdk_api',
-    version: '0.1.0-beta.11',
-  },
-  {
-    capabilities: {
-      tools: {},
-    },
+    version: '0.1.0',
   },
+  { capabilities: { tools: {} } },
 );
 
 /**
  * Initializes the provided MCP Server with the given tools and handlers.
  * If not provided, the default client, tools and handlers will be used.
  */
+export function initMcpServer(params: {
+  server: Server | McpServer;
+  clientOptions: ClientOptions;
+  mcpOptions: McpOptions;
+  endpoints?: { tool: Tool; handler: HandlerFunction }[];
+}) {
+  const transformedEndpoints = selectTools(endpoints, params.mcpOptions);
+  const client = new Metronome(params.clientOptions);
+  const capabilities = {
+    ...defaultClientCapabilities,
+    ...(params.mcpOptions.client ? knownClients[params.mcpOptions.client] : params.mcpOptions.capabilities),
+  };
+  init({ server: params.server, client, endpoints: transformedEndpoints, capabilities });
+}
+
 export function init(params: {
   server: Server | McpServer;
   client?: Metronome;
@@ -43,7 +61,7 @@ export function init(params: {
 
   const endpointMap = Object.fromEntries(providedEndpoints.map((endpoint) => [endpoint.tool.name, endpoint]));
 
-  const client = params.client || new Metronome({});
+  const client = params.client || new Metronome({ defaultHeaders: { 'X-Stainless-MCP': 'true' } });
 
   server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
@@ -65,24 +83,27 @@ export function init(params: {
 /**
  * Selects the tools to include in the MCP Server based on the provided options.
  */
-export function selectTools(endpoints: Endpoint[], options: ParsedOptions) {
+export function selectTools(endpoints: Endpoint[], options: McpOptions) {
   const filteredEndpoints = query(options.filters, endpoints);
 
-  const includedTools = filteredEndpoints;
-
-  if (options.includeAllTools && includedTools.length === 0) {
-    includedTools.push(...endpoints);
-  }
-
-  if (options.includeDynamicTools) {
-    includedTools.push(...dynamicTools(endpoints));
-  }
+  let includedTools = filteredEndpoints;
 
-  if (includedTools.length === 0) {
-    includedTools.push(...endpoints);
+  if (includedTools.length > 0) {
+    if (options.includeDynamicTools) {
+      includedTools = dynamicTools(includedTools);
+    }
+  } else {
+    if (options.includeAllTools) {
+      includedTools = endpoints;
+    } else if (options.includeDynamicTools) {
+      includedTools = dynamicTools(endpoints);
+    } else {
+      includedTools = endpoints;
+    }
   }
 
-  return applyCompatibilityTransformations(includedTools, options.capabilities);
+  const capabilities = { ...defaultClientCapabilities, ...options.capabilities };
+  return applyCompatibilityTransformations(includedTools, capabilities);
 }
 
 /**
@@ -99,15 +120,7 @@ export async function executeHandler(
   if (options.validJson && args) {
     args = parseEmbeddedJSON(args, tool.inputSchema);
   }
-  const result = await handler(client, args || {});
-  return {
-    content: [
-      {
-        type: 'text',
-        text: JSON.stringify(result, null, 2),
-      },
-    ],
-  };
+  return await handler(client, args || {});
 }
 
 export const readEnv = (env: string): string | undefined => {

package/src/tools/index.ts

@@ -1,7 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import Metronome from '@metronome/sdk';
-import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { Metadata, Endpoint, HandlerFunction } from './types';
+
+export { Metadata, Endpoint, HandlerFunction };
 
 import retrieve_v2_contracts from './v2/contracts/retrieve-v2-contracts';
 import list_v2_contracts from './v2/contracts/list-v2-contracts';
@@ -27,6 +28,7 @@ import list_v1_customers from './v1/customers/list-v1-customers';
 import archive_v1_customers from './v1/customers/archive-v1-customers';
 import list_billable_metrics_v1_customers from './v1/customers/list-billable-metrics-v1-customers';
 import list_costs_v1_customers from './v1/customers/list-costs-v1-customers';
+import preview_events_v1_customers from './v1/customers/preview-events-v1-customers';
 import set_ingest_aliases_v1_customers from './v1/customers/set-ingest-aliases-v1-customers';
 import set_name_v1_customers from './v1/customers/set-name-v1-customers';
 import update_config_v1_customers from './v1/customers/update-config-v1-customers';
@@ -56,6 +58,7 @@ import get_embeddable_url_v1_dashboards from './v1/dashboards/get-embeddable-url
 import list_v1_usage from './v1/usage/list-v1-usage';
 import ingest_v1_usage from './v1/usage/ingest-v1-usage';
 import list_with_groups_v1_usage from './v1/usage/list-with-groups-v1-usage';
+import search_v1_usage from './v1/usage/search-v1-usage';
 import list_v1_audit_logs from './v1/audit-logs/list-v1-audit-logs';
 import add_key_v1_custom_fields from './v1/custom-fields/add-key-v1-custom-fields';
 import delete_values_v1_custom_fields from './v1/custom-fields/delete-values-v1-custom-fields';
@@ -103,24 +106,6 @@ import update_rate_cards_contracts_v1_named_schedules from './v1/contracts/rate-
 import retrieve_contracts_v1_named_schedules from './v1/contracts/named-schedules/retrieve-contracts-v1-named-schedules';
 import update_contracts_v1_named_schedules from './v1/contracts/named-schedules/update-contracts-v1-named-schedules';
 
-export type HandlerFunction = (client: Metronome, args: Record<string, unknown> | undefined) => Promise<any>;
-
-export type Metadata = {
-  resource: string;
-  operation: 'read' | 'write';
-  tags: string[];
-
-  httpMethod?: string;
-  httpPath?: string;
-  operationId?: string;
-};
-
-export type Endpoint = {
-  metadata: Metadata;
-  tool: Tool;
-  handler: HandlerFunction;
-};
-
 export const endpoints: Endpoint[] = [];
 
 function addEndpoint(endpoint: Endpoint) {
@@ -151,6 +136,7 @@ addEndpoint(list_v1_customers);
 addEndpoint(archive_v1_customers);
 addEndpoint(list_billable_metrics_v1_customers);
 addEndpoint(list_costs_v1_customers);
+addEndpoint(preview_events_v1_customers);
 addEndpoint(set_ingest_aliases_v1_customers);
 addEndpoint(set_name_v1_customers);
 addEndpoint(update_config_v1_customers);
@@ -180,6 +166,7 @@ addEndpoint(get_embeddable_url_v1_dashboards);
 addEndpoint(list_v1_usage);
 addEndpoint(ingest_v1_usage);
 addEndpoint(list_with_groups_v1_usage);
+addEndpoint(search_v1_usage);
 addEndpoint(list_v1_audit_logs);
 addEndpoint(add_key_v1_custom_fields);
 addEndpoint(delete_values_v1_custom_fields);
@@ -251,9 +238,10 @@ export function query(filters: Filter[], endpoints: Endpoint[]): Endpoint[] {
   });
 
   // Check if any filters didn't match
-  if (unmatchedFilters.size > 0) {
+  const unmatched = Array.from(unmatchedFilters).filter((f) => f.type === 'tool' || f.type === 'resource');
+  if (unmatched.length > 0) {
     throw new Error(
-      `The following filters did not match any endpoints: ${[...unmatchedFilters]
+      `The following filters did not match any endpoints: ${unmatched
         .map((f) => `${f.type}=${f.value}`)
         .join(', ')}`,
     );

package/src/tools/types.ts

@@ -0,0 +1,103 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import Metronome from '@metronome/sdk';
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+
+type TextContentBlock = {
+  type: 'text';
+  text: string;
+};
+
+type ImageContentBlock = {
+  type: 'image';
+  data: string;
+  mimeType: string;
+};
+
+type AudioContentBlock = {
+  type: 'audio';
+  data: string;
+  mimeType: string;
+};
+
+type ResourceContentBlock = {
+  type: 'resource';
+  resource:
+    | {
+        uri: string;
+        mimeType: string;
+        text: string;
+      }
+    | {
+        uri: string;
+        mimeType: string;
+        blob: string;
+      };
+};
+
+export type ContentBlock = TextContentBlock | ImageContentBlock | AudioContentBlock | ResourceContentBlock;
+
+export type ToolCallResult = {
+  content: ContentBlock[];
+  isError?: boolean;
+};
+
+export type HandlerFunction = (
+  client: Metronome,
+  args: Record<string, unknown> | undefined,
+) => Promise<ToolCallResult>;
+
+export function asTextContentResult(result: unknown): ToolCallResult {
+  return {
+    content: [
+      {
+        type: 'text',
+        text: JSON.stringify(result, null, 2),
+      },
+    ],
+  };
+}
+
+export async function asBinaryContentResult(response: Response): Promise<ToolCallResult> {
+  const blob = await response.blob();
+  const mimeType = blob.type;
+  const data = Buffer.from(await blob.arrayBuffer()).toString('base64');
+  if (mimeType.startsWith('image/')) {
+    return {
+      content: [{ type: 'image', mimeType, data }],
+    };
+  } else if (mimeType.startsWith('audio/')) {
+    return {
+      content: [{ type: 'audio', mimeType, data }],
+    };
+  } else {
+    return {
+      content: [
+        {
+          type: 'resource',
+          resource: {
+            // We must give a URI, even though this isn't actually an MCP resource.
+            uri: 'resource://tool-response',
+            mimeType,
+            blob: data,
+          },
+        },
+      ],
+    };
+  }
+}
+
+export type Metadata = {
+  resource: string;
+  operation: 'read' | 'write';
+  tags: string[];
+  httpMethod?: string;
+  httpPath?: string;
+  operationId?: string;
+};
+
+export type Endpoint = {
+  metadata: Metadata;
+  tool: Tool;
+  handler: HandlerFunction;
+};

package/src/tools/v1/alerts/archive-v1-alerts.ts

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from '@metronome/mcp/filtering';
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -15,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'archive_v1_alerts',
-  description: 'Archive an existing alert',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nArchive an existing alert\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -27,13 +30,21 @@ export const tool: Tool = {
         type: 'boolean',
         description: 'If true, resets the uniqueness key on this alert so it can be re-used',
       },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
     },
+    required: ['id'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.alerts.archive(body);
+  return asTextContentResult(await maybeFilter(args, await client.v1.alerts.archive(body)));
 };
 
 export default { metadata, tool, handler };

package/src/tools/v1/alerts/create-v1-alerts.ts

@@ -1,7 +1,9 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import { maybeFilter } from '@metronome/mcp/filtering';
+import { Metadata, asTextContentResult } from '@metronome/mcp/tools/types';
+
 import { Tool } from '@modelcontextprotocol/sdk/types.js';
-import type { Metadata } from '../../';
 import Metronome from '@metronome/sdk';
 
 export const metadata: Metadata = {
@@ -15,7 +17,8 @@ export const metadata: Metadata = {
 
 export const tool: Tool = {
   name: 'create_v1_alerts',
-  description: 'Create a new alert',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCreate a new alert\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    data: {\n      $ref: '#/$defs/id'\n    }\n  },\n  required: [    'data'\n  ],\n  $defs: {\n    id: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        }\n      },\n      required: [        'id'\n      ]\n    }\n  }\n}\n```",
   inputSchema: {
     type: 'object',
     properties: {
@@ -63,6 +66,8 @@ export const tool: Tool = {
       },
       credit_type_id: {
         type: 'string',
+        description:
+          "ID of the credit's currency, defaults to USD. If the specific alert type requires a pricing unit/currency, find the ID in the [Metronome app](https://app.metronome.com/offering/pricing-units).",
       },
       custom_field_filters: {
         type: 'array',
@@ -126,13 +131,21 @@ export const tool: Tool = {
         description:
           'Prevents the creation of duplicates. If a request to create a record is made with a previously used uniqueness key, a new record will not be created and the request will fail with a 409 error.',
       },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
     },
+    required: ['alert_type', 'name', 'threshold'],
   },
+  annotations: {},
 };
 
-export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+export const handler = async (client: Metronome, args: Record<string, unknown> | undefined) => {
   const body = args as any;
-  return client.v1.alerts.create(body);
+  return asTextContentResult(await maybeFilter(args, await client.v1.alerts.create(body)));
 };
 
 export default { metadata, tool, handler };