@metronome/mcp 0.1.0-beta.11

package/src/tools/v1/usage/list-v1-usage.ts

@@ -0,0 +1,90 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v1.usage',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/usage',
+  operationId: 'getUsageBatch-v1',
+};
+
+export const tool: Tool = {
+  name: 'list_v1_usage',
+  description:
+    'Fetch aggregated usage data for multiple customers and billable-metrics, broken into intervals of the specified length.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      ending_before: {
+        type: 'string',
+        format: 'date-time',
+      },
+      starting_on: {
+        type: 'string',
+        format: 'date-time',
+      },
+      window_size: {
+        type: 'string',
+        description:
+          'A window_size of "day" or "hour" will return the usage for the specified period segmented into daily or hourly aggregates. A window_size of "none" will return a single usage aggregate for the entirety of the specified period.',
+        enum: ['HOUR', 'DAY', 'NONE'],
+      },
+      next_page: {
+        type: 'string',
+        description: 'Cursor that indicates where the next page of results should start.',
+      },
+      billable_metrics: {
+        type: 'array',
+        description:
+          'A list of billable metrics to fetch usage for. If absent, all billable metrics will be returned.',
+        items: {
+          type: 'object',
+          properties: {
+            id: {
+              type: 'string',
+            },
+            group_by: {
+              type: 'object',
+              properties: {
+                key: {
+                  type: 'string',
+                  description: 'The name of the group_by key to use',
+                },
+                values: {
+                  type: 'array',
+                  description:
+                    'Values of the group_by key to return in the query. If this field is omitted, all available values will be returned, up to a maximum of 200.',
+                  items: {
+                    type: 'string',
+                  },
+                },
+              },
+              required: ['key'],
+            },
+          },
+          required: ['id'],
+        },
+      },
+      customer_ids: {
+        type: 'array',
+        description:
+          'A list of Metronome customer IDs to fetch usage for. If absent, usage for all customers will be returned.',
+        items: {
+          type: 'string',
+        },
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v1.usage.list(body);
+};
+
+export default { metadata, tool, handler };

package/src/tools/v1/usage/list-with-groups-v1-usage.ts

@@ -0,0 +1,83 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v1.usage',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/usage/groups',
+  operationId: 'getPagedUsage-v1',
+};
+
+export const tool: Tool = {
+  name: 'list_with_groups_v1_usage',
+  description:
+    'Fetch aggregated usage data for the specified customer, billable-metric, and optional group, broken into intervals of the specified length.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      billable_metric_id: {
+        type: 'string',
+      },
+      customer_id: {
+        type: 'string',
+      },
+      window_size: {
+        type: 'string',
+        description:
+          'A window_size of "day" or "hour" will return the usage for the specified period segmented into daily or hourly aggregates. A window_size of "none" will return a single usage aggregate for the entirety of the specified period.',
+        enum: ['HOUR', 'DAY', 'NONE'],
+      },
+      limit: {
+        type: 'integer',
+        description: 'Max number of results that should be returned',
+      },
+      next_page: {
+        type: 'string',
+        description: 'Cursor that indicates where the next page of results should start.',
+      },
+      current_period: {
+        type: 'boolean',
+        description:
+          'If true, will return the usage for the current billing period. Will return an error if the customer is currently uncontracted or starting_on and ending_before are specified when this is true.',
+      },
+      ending_before: {
+        type: 'string',
+        format: 'date-time',
+      },
+      group_by: {
+        type: 'object',
+        properties: {
+          key: {
+            type: 'string',
+            description: 'The name of the group_by key to use',
+          },
+          values: {
+            type: 'array',
+            description:
+              "Values of the group_by key to return in the query. Omit this if you'd like all values for the key returned.",
+            items: {
+              type: 'string',
+            },
+          },
+        },
+        required: ['key'],
+      },
+      starting_on: {
+        type: 'string',
+        format: 'date-time',
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v1.usage.listWithGroups(body);
+};
+
+export default { metadata, tool, handler };

package/src/tools/v2/contracts/edit-commit-v2-contracts.ts

@@ -0,0 +1,218 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v2.contracts',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v2/contracts/commits/edit',
+  operationId: 'editCommit-v2',
+};
+
+export const tool: Tool = {
+  name: 'edit_commit_v2_contracts',
+  description:
+    'Edit a customer or contract commit. Contract commits can only be edited using this endpoint if contract editing is enabled.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      commit_id: {
+        type: 'string',
+        description: 'ID of the commit to edit',
+      },
+      customer_id: {
+        type: 'string',
+        description: 'ID of the customer whose commit is being edited',
+      },
+      access_schedule: {
+        type: 'object',
+        properties: {
+          add_schedule_items: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                amount: {
+                  type: 'number',
+                },
+                ending_before: {
+                  type: 'string',
+                  format: 'date-time',
+                },
+                starting_at: {
+                  type: 'string',
+                  format: 'date-time',
+                },
+              },
+              required: ['amount', 'ending_before', 'starting_at'],
+            },
+          },
+          remove_schedule_items: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                id: {
+                  type: 'string',
+                },
+              },
+              required: ['id'],
+            },
+          },
+          update_schedule_items: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                id: {
+                  type: 'string',
+                },
+                amount: {
+                  type: 'number',
+                },
+                ending_before: {
+                  type: 'string',
+                  format: 'date-time',
+                },
+                starting_at: {
+                  type: 'string',
+                  format: 'date-time',
+                },
+              },
+              required: ['id'],
+            },
+          },
+        },
+        required: [],
+      },
+      applicable_product_ids: {
+        type: 'array',
+        description:
+          'Which products the commit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the commit applies to all products.',
+        items: {
+          type: 'string',
+        },
+      },
+      applicable_product_tags: {
+        type: 'array',
+        description:
+          'Which tags the commit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the commit applies to all products.',
+        items: {
+          type: 'string',
+        },
+      },
+      invoice_contract_id: {
+        type: 'string',
+        description: 'ID of contract to use for invoicing',
+      },
+      invoice_schedule: {
+        type: 'object',
+        properties: {
+          add_schedule_items: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                timestamp: {
+                  type: 'string',
+                  format: 'date-time',
+                },
+                amount: {
+                  type: 'number',
+                },
+                quantity: {
+                  type: 'number',
+                },
+                unit_price: {
+                  type: 'number',
+                },
+              },
+              required: ['timestamp'],
+            },
+          },
+          remove_schedule_items: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                id: {
+                  type: 'string',
+                },
+              },
+              required: ['id'],
+            },
+          },
+          update_schedule_items: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                id: {
+                  type: 'string',
+                },
+                amount: {
+                  type: 'number',
+                },
+                quantity: {
+                  type: 'number',
+                },
+                timestamp: {
+                  type: 'string',
+                  format: 'date-time',
+                },
+                unit_price: {
+                  type: 'number',
+                },
+              },
+              required: ['id'],
+            },
+          },
+        },
+        required: [],
+      },
+      product_id: {
+        type: 'string',
+      },
+      specifiers: {
+        type: 'array',
+        description:
+          "List of filters that determine what kind of customer usage draws down a commit or credit. A customer's usage needs to meet the condition of at least one of the specifiers to contribute to a commit's or credit's drawdown. This field cannot be used together with `applicable_product_ids` or `applicable_product_tags`.",
+        items: {
+          type: 'object',
+          properties: {
+            presentation_group_values: {
+              type: 'object',
+            },
+            pricing_group_values: {
+              type: 'object',
+            },
+            product_id: {
+              type: 'string',
+              description: 'If provided, the specifier will only apply to the product with the specified ID.',
+            },
+            product_tags: {
+              type: 'array',
+              description:
+                'If provided, the specifier will only apply to products with all the specified tags.',
+              items: {
+                type: 'string',
+              },
+            },
+          },
+          required: [],
+        },
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v2.contracts.editCommit(body);
+};
+
+export default { metadata, tool, handler };

package/src/tools/v2/contracts/edit-credit-v2-contracts.ts

@@ -0,0 +1,149 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { Metadata } from '../../';
+import Metronome from '@metronome/sdk';
+
+export const metadata: Metadata = {
+  resource: 'v2.contracts',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v2/contracts/credits/edit',
+  operationId: 'editCredit-v2',
+};
+
+export const tool: Tool = {
+  name: 'edit_credit_v2_contracts',
+  description:
+    'Edit a customer or contract credit. Contract credits can only be edited using this endpoint if contract editing is enabled.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      credit_id: {
+        type: 'string',
+        description: 'ID of the credit to edit',
+      },
+      customer_id: {
+        type: 'string',
+        description: 'ID of the customer whose credit is being edited',
+      },
+      access_schedule: {
+        type: 'object',
+        properties: {
+          add_schedule_items: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                amount: {
+                  type: 'number',
+                },
+                ending_before: {
+                  type: 'string',
+                  format: 'date-time',
+                },
+                starting_at: {
+                  type: 'string',
+                  format: 'date-time',
+                },
+              },
+              required: ['amount', 'ending_before', 'starting_at'],
+            },
+          },
+          remove_schedule_items: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                id: {
+                  type: 'string',
+                },
+              },
+              required: ['id'],
+            },
+          },
+          update_schedule_items: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                id: {
+                  type: 'string',
+                },
+                amount: {
+                  type: 'number',
+                },
+                ending_before: {
+                  type: 'string',
+                  format: 'date-time',
+                },
+                starting_at: {
+                  type: 'string',
+                  format: 'date-time',
+                },
+              },
+              required: ['id'],
+            },
+          },
+        },
+        required: [],
+      },
+      applicable_product_ids: {
+        type: 'array',
+        description:
+          'Which products the credit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the credit applies to all products.',
+        items: {
+          type: 'string',
+        },
+      },
+      applicable_product_tags: {
+        type: 'array',
+        description:
+          'Which tags the credit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the credit applies to all products.',
+        items: {
+          type: 'string',
+        },
+      },
+      product_id: {
+        type: 'string',
+      },
+      specifiers: {
+        type: 'array',
+        description:
+          "List of filters that determine what kind of customer usage draws down a commit or credit. A customer's usage needs to meet the condition of at least one of the specifiers to contribute to a commit's or credit's drawdown. This field cannot be used together with `applicable_product_ids` or `applicable_product_tags`.",
+        items: {
+          type: 'object',
+          properties: {
+            presentation_group_values: {
+              type: 'object',
+            },
+            pricing_group_values: {
+              type: 'object',
+            },
+            product_id: {
+              type: 'string',
+              description: 'If provided, the specifier will only apply to the product with the specified ID.',
+            },
+            product_tags: {
+              type: 'array',
+              description:
+                'If provided, the specifier will only apply to products with all the specified tags.',
+              items: {
+                type: 'string',
+              },
+            },
+          },
+          required: [],
+        },
+      },
+    },
+  },
+};
+
+export const handler = (client: Metronome, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  return client.v2.contracts.editCredit(body);
+};
+
+export default { metadata, tool, handler };