@metronome/mcp 0.1.0-beta.11 → 0.1.0

package/tools/v1/contracts/create-v1-contracts.js

@@ -2,6 +2,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handler = exports.tool = exports.metadata = void 0;
+const types_1 = require("@metronome/mcp/tools/types");
 exports.metadata = {
     resource: 'v1.contracts',
     operation: 'write',
@@ -12,7 +13,7 @@ exports.metadata = {
 };
 exports.tool = {
     name: 'create_v1_contracts',
-    description: 'Create a new contract\n',
+    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 contract\n",
     inputSchema: {
         type: 'object',
         properties: {
@@ -26,22 +27,23 @@ exports.tool = {
             },
             billing_provider_configuration: {
                 type: 'object',
-                description: 'The billing provider configuration associated with a contract.',
+                description: 'The billing provider configuration associated with a contract. Provide either an ID or the provider and delivery method.',
                 properties: {
                     billing_provider: {
                         type: 'string',
+                        description: 'Do not specify if using billing_provider_configuration_id.',
                         enum: ['aws_marketplace', 'azure_marketplace', 'gcp_marketplace', 'stripe', 'netsuite'],
                     },
                     billing_provider_configuration_id: {
                         type: 'string',
-                        description: 'The Metronome ID of the billing provider configuration',
+                        description: 'The Metronome ID of the billing provider configuration. Use when a customer has multiple configurations with the same billing provider and delivery method. Otherwise, specify the billing_provider and delivery_method.',
                     },
                     delivery_method: {
                         type: 'string',
+                        description: 'Do not specify if using billing_provider_configuration_id.',
                         enum: ['direct_to_billing_provider', 'aws_sqs', 'tackle', 'aws_sns'],
                     },
                 },
-                required: [],
             },
             commits: {
                 type: 'array',
@@ -94,14 +96,14 @@ exports.tool = {
                         },
                         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.',
+                            description: 'Which products the commit applies to. If applicable_product_ids, applicable_product_tags or specifiers 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.',
+                            description: 'Which tags the commit applies to. If applicable_product_ids, applicable_product_tags or specifiers are not provided, the commit applies to all products.',
                             items: {
                                 type: 'string',
                             },
@@ -113,6 +115,53 @@ exports.tool = {
                             type: 'string',
                             description: 'Used only in UI/API. It is not exposed to end customers.',
                         },
+                        hierarchy_configuration: {
+                            type: 'object',
+                            description: 'Optional configuration for commit hierarchy access control',
+                            properties: {
+                                child_access: {
+                                    anyOf: [
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                type: {
+                                                    type: 'string',
+                                                    enum: ['ALL'],
+                                                },
+                                            },
+                                            required: ['type'],
+                                        },
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                type: {
+                                                    type: 'string',
+                                                    enum: ['NONE'],
+                                                },
+                                            },
+                                            required: ['type'],
+                                        },
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                contract_ids: {
+                                                    type: 'array',
+                                                    items: {
+                                                        type: 'string',
+                                                    },
+                                                },
+                                                type: {
+                                                    type: 'string',
+                                                    enum: ['CONTRACT_IDS'],
+                                                },
+                                            },
+                                            required: ['contract_ids', 'type'],
+                                        },
+                                    ],
+                                },
+                            },
+                            required: ['child_access'],
+                        },
                         invoice_schedule: {
                             type: 'object',
                             description: 'Required for "POSTPAID" commits: the true up invoice will be generated at this time and only one schedule item is allowed; the total must match access_schedule amount. Optional for "PREPAID" commits: if not provided, this will be a "complimentary" commit with no invoice.',
@@ -186,7 +235,6 @@ exports.tool = {
                                     },
                                 },
                             },
-                            required: [],
                         },
                         name: {
                             type: 'string',
@@ -205,22 +253,41 @@ exports.tool = {
                                     description: 'Gate access to the commit balance based on successful collection of payment. Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to facilitate payment using your own payment integration. Select NONE if you do not wish to payment gate the commit balance.',
                                     enum: ['NONE', 'STRIPE', 'EXTERNAL'],
                                 },
+                                precalculated_tax_config: {
+                                    type: 'object',
+                                    description: 'Only applicable if using PRECALCULATED as your tax type.',
+                                    properties: {
+                                        tax_amount: {
+                                            type: 'number',
+                                            description: "Amount of tax to be applied. This should be in the same currency and denomination  as the commit's invoice schedule",
+                                        },
+                                        tax_name: {
+                                            type: 'string',
+                                            description: 'Name of the tax to be applied. This may be used in an invoice line item description.',
+                                        },
+                                    },
+                                    required: ['tax_amount'],
+                                },
                                 stripe_config: {
                                     type: 'object',
-                                    description: 'Only applicable if using Stripe as your payment gateway through Metronome.',
+                                    description: 'Only applicable if using STRIPE as your payment gate type.',
                                     properties: {
                                         payment_type: {
                                             type: 'string',
                                             description: 'If left blank, will default to INVOICE',
                                             enum: ['INVOICE', 'PAYMENT_INTENT'],
                                         },
+                                        invoice_metadata: {
+                                            type: 'object',
+                                            description: 'Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as your payment type.',
+                                        },
                                     },
                                     required: ['payment_type'],
                                 },
                                 tax_type: {
                                     type: 'string',
                                     description: 'Stripe tax is only supported for Stripe payment gateway. Select NONE if you do not wish Metronome to calculate tax on your behalf. Leaving this field blank will default to NONE.',
-                                    enum: ['NONE', 'STRIPE'],
+                                    enum: ['NONE', 'STRIPE', 'ANROK', 'PRECALCULATED'],
                                 },
                             },
                             required: ['payment_gate_type'],
@@ -261,7 +328,6 @@ exports.tool = {
                                         },
                                     },
                                 },
-                                required: [],
                             },
                         },
                         temporary_id: {
@@ -334,6 +400,53 @@ exports.tool = {
                             type: 'string',
                             description: 'Used only in UI/API. It is not exposed to end customers.',
                         },
+                        hierarchy_configuration: {
+                            type: 'object',
+                            description: 'Optional configuration for credit hierarchy access control',
+                            properties: {
+                                child_access: {
+                                    anyOf: [
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                type: {
+                                                    type: 'string',
+                                                    enum: ['ALL'],
+                                                },
+                                            },
+                                            required: ['type'],
+                                        },
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                type: {
+                                                    type: 'string',
+                                                    enum: ['NONE'],
+                                                },
+                                            },
+                                            required: ['type'],
+                                        },
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                contract_ids: {
+                                                    type: 'array',
+                                                    items: {
+                                                        type: 'string',
+                                                    },
+                                                },
+                                                type: {
+                                                    type: 'string',
+                                                    enum: ['CONTRACT_IDS'],
+                                                },
+                                            },
+                                            required: ['contract_ids', 'type'],
+                                        },
+                                    ],
+                                },
+                            },
+                            required: ['child_access'],
+                        },
                         name: {
                             type: 'string',
                             description: 'displayed on invoices',
@@ -374,7 +487,6 @@ exports.tool = {
                                         },
                                     },
                                 },
-                                required: [],
                             },
                         },
                     },
@@ -466,7 +578,6 @@ exports.tool = {
                                     },
                                 },
                             },
-                            required: [],
                         },
                         custom_fields: {
                             type: 'object',
@@ -488,6 +599,24 @@ exports.tool = {
                 description: 'exclusive contract end time',
                 format: 'date-time',
             },
+            hierarchy_configuration: {
+                type: 'object',
+                properties: {
+                    parent: {
+                        type: 'object',
+                        properties: {
+                            contract_id: {
+                                type: 'string',
+                            },
+                            customer_id: {
+                                type: 'string',
+                            },
+                        },
+                        required: ['contract_id', 'customer_id'],
+                    },
+                },
+                required: ['parent'],
+            },
             multiplier_override_prioritization: {
                 type: 'string',
                 description: 'Defaults to LOWEST_MULTIPLIER, which applies the greatest discount to list prices automatically. EXPLICIT prioritization requires specifying priorities for each multiplier; the one with the lowest priority value will be prioritized first. If tiered overrides are used, prioritization must be explicit.',
@@ -587,7 +716,6 @@ exports.tool = {
                                         },
                                     },
                                 },
-                                required: [],
                             },
                         },
                         overwrite_rate: {
@@ -677,14 +805,14 @@ exports.tool = {
                             },
                             applicable_product_ids: {
                                 type: 'array',
-                                description: 'Which products the threshold commit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the commit applies to all products.',
+                                description: 'Which products the threshold commit applies to. If applicable_product_ids, applicable_product_tags or specifiers are not provided, the commit applies to all products.',
                                 items: {
                                     type: 'string',
                                 },
                             },
                             applicable_product_tags: {
                                 type: 'array',
-                                description: 'Which tags the threshold commit applies to. If both applicable_product_ids and applicable_product_tags are not provided, the commit applies to all products.',
+                                description: 'Which tags the threshold commit applies to. If applicable_product_ids, applicable_product_tags or specifiers are not provided, the commit applies to all products.',
                                 items: {
                                     type: 'string',
                                 },
@@ -720,7 +848,6 @@ exports.tool = {
                                             },
                                         },
                                     },
-                                    required: [],
                                 },
                             },
                         },
@@ -738,22 +865,41 @@ exports.tool = {
                                 description: 'Gate access to the commit balance based on successful collection of payment. Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to facilitate payment using your own payment integration. Select NONE if you do not wish to payment gate the commit balance.',
                                 enum: ['NONE', 'STRIPE', 'EXTERNAL'],
                             },
+                            precalculated_tax_config: {
+                                type: 'object',
+                                description: 'Only applicable if using PRECALCULATED as your tax type.',
+                                properties: {
+                                    tax_amount: {
+                                        type: 'number',
+                                        description: "Amount of tax to be applied. This should be in the same currency and denomination  as the commit's invoice schedule",
+                                    },
+                                    tax_name: {
+                                        type: 'string',
+                                        description: 'Name of the tax to be applied. This may be used in an invoice line item description.',
+                                    },
+                                },
+                                required: ['tax_amount'],
+                            },
                             stripe_config: {
                                 type: 'object',
-                                description: 'Only applicable if using Stripe as your payment gateway through Metronome.',
+                                description: 'Only applicable if using STRIPE as your payment gate type.',
                                 properties: {
                                     payment_type: {
                                         type: 'string',
                                         description: 'If left blank, will default to INVOICE',
                                         enum: ['INVOICE', 'PAYMENT_INTENT'],
                                     },
+                                    invoice_metadata: {
+                                        type: 'object',
+                                        description: 'Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as your payment type.',
+                                    },
                                 },
                                 required: ['payment_type'],
                             },
                             tax_type: {
                                 type: 'string',
                                 description: 'Stripe tax is only supported for Stripe payment gateway. Select NONE if you do not wish Metronome to calculate tax on your behalf. Leaving this field blank will default to NONE.',
-                                enum: ['NONE', 'STRIPE'],
+                                enum: ['NONE', 'STRIPE', 'ANROK', 'PRECALCULATED'],
                             },
                         },
                         required: ['payment_gate_type'],
@@ -766,9 +912,17 @@ exports.tool = {
                         type: 'number',
                         description: "Specify the threshold amount for the contract. Each time the contract's prepaid balance lowers to this amount, a threshold charge will be initiated.",
                     },
+                    custom_credit_type_id: {
+                        type: 'string',
+                        description: 'If provided, the threshold, recharge-to amount, and the resulting threshold commit amount will be in terms of this credit type instead of the fiat currency.',
+                    },
                 },
                 required: ['commit', 'is_enabled', 'payment_gate_config', 'recharge_to_amount', 'threshold_amount'],
             },
+            priority: {
+                type: 'number',
+                description: 'Priority of the contract.',
+            },
             professional_services: {
                 type: 'array',
                 description: "This field's availability is dependent on your client's configuration.",
@@ -823,28 +977,29 @@ exports.tool = {
                                 credit_type_id: {
                                     type: 'string',
                                 },
-                                quantity: {
+                                unit_price: {
                                     type: 'number',
                                 },
-                                unit_price: {
+                                quantity: {
                                     type: 'number',
+                                    description: 'This field is currently required. Upcoming recurring commit/credit configuration options will allow it to be optional.',
                                 },
                             },
-                            required: ['credit_type_id', 'quantity', 'unit_price'],
+                            required: ['credit_type_id', 'unit_price'],
                         },
                         commit_duration: {
                             type: 'object',
-                            description: 'The amount of time the created commits will be valid for.',
+                            description: 'Defines the length of the access schedule for each created commit/credit. The value represents the number of units. Unit defaults to "PERIODS", where the length of a period is determined by the recurrence_frequency.',
                             properties: {
+                                value: {
+                                    type: 'number',
+                                },
                                 unit: {
                                     type: 'string',
                                     enum: ['PERIODS'],
                                 },
-                                value: {
-                                    type: 'number',
-                                },
                             },
-                            required: ['unit', 'value'],
+                            required: ['value'],
                         },
                         priority: {
                             type: 'number',
@@ -881,6 +1036,53 @@ exports.tool = {
                             description: 'Determines when the contract will stop creating recurring commits. optional',
                             format: 'date-time',
                         },
+                        hierarchy_configuration: {
+                            type: 'object',
+                            description: 'Optional configuration for recurring commit/credit hierarchy access control',
+                            properties: {
+                                child_access: {
+                                    anyOf: [
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                type: {
+                                                    type: 'string',
+                                                    enum: ['ALL'],
+                                                },
+                                            },
+                                            required: ['type'],
+                                        },
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                type: {
+                                                    type: 'string',
+                                                    enum: ['NONE'],
+                                                },
+                                            },
+                                            required: ['type'],
+                                        },
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                contract_ids: {
+                                                    type: 'array',
+                                                    items: {
+                                                        type: 'string',
+                                                    },
+                                                },
+                                                type: {
+                                                    type: 'string',
+                                                    enum: ['CONTRACT_IDS'],
+                                                },
+                                            },
+                                            required: ['contract_ids', 'type'],
+                                        },
+                                    ],
+                                },
+                            },
+                            required: ['child_access'],
+                        },
                         invoice_amount: {
                             type: 'object',
                             description: 'The amount the customer should be billed for the commit. Not required.',
@@ -948,7 +1150,6 @@ exports.tool = {
                                         },
                                     },
                                 },
-                                required: [],
                             },
                         },
                         temporary_id: {
@@ -971,28 +1172,29 @@ exports.tool = {
                                 credit_type_id: {
                                     type: 'string',
                                 },
-                                quantity: {
+                                unit_price: {
                                     type: 'number',
                                 },
-                                unit_price: {
+                                quantity: {
                                     type: 'number',
+                                    description: 'This field is currently required. Upcoming recurring commit/credit configuration options will allow it to be optional.',
                                 },
                             },
-                            required: ['credit_type_id', 'quantity', 'unit_price'],
+                            required: ['credit_type_id', 'unit_price'],
                         },
                         commit_duration: {
                             type: 'object',
-                            description: 'The amount of time the created commits will be valid for.',
+                            description: 'Defines the length of the access schedule for each created commit/credit. The value represents the number of units. Unit defaults to "PERIODS", where the length of a period is determined by the recurrence_frequency.',
                             properties: {
+                                value: {
+                                    type: 'number',
+                                },
                                 unit: {
                                     type: 'string',
                                     enum: ['PERIODS'],
                                 },
-                                value: {
-                                    type: 'number',
-                                },
                             },
-                            required: ['unit', 'value'],
+                            required: ['value'],
                         },
                         priority: {
                             type: 'number',
@@ -1029,6 +1231,53 @@ exports.tool = {
                             description: 'Determines when the contract will stop creating recurring commits. optional',
                             format: 'date-time',
                         },
+                        hierarchy_configuration: {
+                            type: 'object',
+                            description: 'Optional configuration for recurring commit/credit hierarchy access control',
+                            properties: {
+                                child_access: {
+                                    anyOf: [
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                type: {
+                                                    type: 'string',
+                                                    enum: ['ALL'],
+                                                },
+                                            },
+                                            required: ['type'],
+                                        },
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                type: {
+                                                    type: 'string',
+                                                    enum: ['NONE'],
+                                                },
+                                            },
+                                            required: ['type'],
+                                        },
+                                        {
+                                            type: 'object',
+                                            properties: {
+                                                contract_ids: {
+                                                    type: 'array',
+                                                    items: {
+                                                        type: 'string',
+                                                    },
+                                                },
+                                                type: {
+                                                    type: 'string',
+                                                    enum: ['CONTRACT_IDS'],
+                                                },
+                                            },
+                                            required: ['contract_ids', 'type'],
+                                        },
+                                    ],
+                                },
+                            },
+                            required: ['child_access'],
+                        },
                         name: {
                             type: 'string',
                             description: 'displayed on invoices. will be passed through to the individual commits',
@@ -1080,7 +1329,6 @@ exports.tool = {
                                         },
                                     },
                                 },
-                                required: [],
                             },
                         },
                         temporary_id: {
@@ -1138,7 +1386,6 @@ exports.tool = {
                                     type: 'string',
                                 },
                             },
-                            required: [],
                         },
                         ending_before: {
                             type: 'string',
@@ -1154,7 +1401,6 @@ exports.tool = {
                                     type: 'string',
                                 },
                             },
-                            required: [],
                         },
                         reseller_contract_value: {
                             type: 'number',
@@ -1248,7 +1494,6 @@ exports.tool = {
                                     },
                                 },
                             },
-                            required: [],
                         },
                         name: {
                             type: 'string',
@@ -1299,22 +1544,41 @@ exports.tool = {
                                 description: 'Gate access to the commit balance based on successful collection of payment. Select STRIPE for Metronome to facilitate payment via Stripe. Select EXTERNAL to facilitate payment using your own payment integration. Select NONE if you do not wish to payment gate the commit balance.',
                                 enum: ['NONE', 'STRIPE', 'EXTERNAL'],
                             },
+                            precalculated_tax_config: {
+                                type: 'object',
+                                description: 'Only applicable if using PRECALCULATED as your tax type.',
+                                properties: {
+                                    tax_amount: {
+                                        type: 'number',
+                                        description: "Amount of tax to be applied. This should be in the same currency and denomination  as the commit's invoice schedule",
+                                    },
+                                    tax_name: {
+                                        type: 'string',
+                                        description: 'Name of the tax to be applied. This may be used in an invoice line item description.',
+                                    },
+                                },
+                                required: ['tax_amount'],
+                            },
                             stripe_config: {
                                 type: 'object',
-                                description: 'Only applicable if using Stripe as your payment gateway through Metronome.',
+                                description: 'Only applicable if using STRIPE as your payment gate type.',
                                 properties: {
                                     payment_type: {
                                         type: 'string',
                                         description: 'If left blank, will default to INVOICE',
                                         enum: ['INVOICE', 'PAYMENT_INTENT'],
                                     },
+                                    invoice_metadata: {
+                                        type: 'object',
+                                        description: 'Metadata to be added to the Stripe invoice. Only applicable if using INVOICE as your payment type.',
+                                    },
                                 },
                                 required: ['payment_type'],
                             },
                             tax_type: {
                                 type: 'string',
                                 description: 'Stripe tax is only supported for Stripe payment gateway. Select NONE if you do not wish Metronome to calculate tax on your behalf. Leaving this field blank will default to NONE.',
-                                enum: ['NONE', 'STRIPE'],
+                                enum: ['NONE', 'STRIPE', 'ANROK', 'PRECALCULATED'],
                             },
                         },
                         required: ['payment_gate_type'],
@@ -1328,7 +1592,7 @@ exports.tool = {
             },
             subscriptions: {
                 type: 'array',
-                description: '(beta) Optional list of [subscriptions](https://docs.metronome.com/manage-product-access/create-subscription/) to add to the contract.',
+                description: 'Optional list of [subscriptions](https://docs.metronome.com/manage-product-access/create-subscription/) to add to the contract.',
                 items: {
                     type: 'object',
                     properties: {
@@ -1353,7 +1617,6 @@ exports.tool = {
                                     description: 'Indicates if the partial period will be prorated or charged a full amount.',
                                 },
                             },
-                            required: [],
                         },
                         subscription_rate: {
                             type: 'object',
@@ -1417,7 +1680,6 @@ exports.tool = {
                                 enum: ['REMOVE', 'AS_IS'],
                             },
                         },
-                        required: [],
                     },
                 },
                 required: ['from_contract_id', 'type'],
@@ -1455,6 +1717,7 @@ exports.tool = {
                 required: ['frequency'],
             },
         },
+        required: ['customer_id', 'starting_at'],
         $defs: {
             tier: {
                 type: 'object',
@@ -1489,10 +1752,11 @@ exports.tool = {
             },
         },
     },
+    annotations: {},
 };
-const handler = (client, args) => {
+const handler = async (client, args) => {
     const body = args;
-    return client.v1.contracts.create(body);
+    return (0, types_1.asTextContentResult)(await client.v1.contracts.create(body));
 };
 exports.handler = handler;
 exports.default = { metadata: exports.metadata, tool: exports.tool, handler: exports.handler };