mcp-prqx-pricer 1.0.13 → 1.0.14

package/build/tools/createPricingGroup.js

@@ -104,28 +104,34 @@ class CreatePricingGroupTool {
             if (!request?.params?.arguments) {
                 throw new Error('Missing arguments');
             }
+            const pricingGroupRequestRanks = request.params.arguments.pricingGroupRequestRanks;
+            const anchorTicketGroupId = pricingGroupRequestRanks.find(rank => rank.rank === 0)?.ticketGroupId;
+            if (!anchorTicketGroupId) {
+                throw new Error('Anchor ticket group ID is required');
+            }
+            const defaultsResponse = await httpClient.get('/v1/client/org-defaults/calculate-defaults/' + anchorTicketGroupId);
+            const defaults = defaultsResponse.data;
             const productionId = request.params.arguments.productionId;
             const name = request.params.arguments.name;
-            const ceilingPrice = request.params.arguments.ceilingPrice;
-            const floorPrice = request.params.arguments.floorPrice;
+            const ceilingPrice = request.params.arguments.ceilingPrice ?? defaults.ruleSet.ceiling;
+            const floorPrice = request.params.arguments.floorPrice ?? defaults.ruleSet.floor;
             const pricingGroupRequestType = request.params.arguments.pricingGroupMode;
-            const amount = request.params.arguments.amount;
-            const increment = request.params.arguments.increment;
-            const incrementMethod = request.params.arguments.incrementMethod;
-            const offsetAmount = request.params.arguments.offsetAmount;
-            const offsetIncrement = request.params.arguments.offsetIncrement;
-            const offsetIncrementMethod = request.params.arguments.offsetIncrementMethod;
-            const enableShareOptions = request.params.arguments.enableShareOptions;
-            const shareOptionsType = request.params.arguments.shareOptionsType;
-            const shareAnchor = request.params.arguments.shareAnchor;
-            const customSharingAmount = request.params.arguments.customSharingAmount;
-            const customSharingMethod = request.params.arguments.customSharingMethod;
-            const applyCeilingOnlyToAnchor = request.params.arguments.applyCeilingOnlyToAnchor;
-            const applyFloorOnlyToAnchor = request.params.arguments.applyFloorOnlyToAnchor;
-            const floorPricingMethod = request.params.arguments.floorPricingMethod;
-            const ceilingPricingMethod = request.params.arguments.ceilingPricingMethod;
-            const noCompPricingMethod = request.params.arguments.noCompPricingMethod;
-            const pricingGroupRequestRanks = request.params.arguments.pricingGroupRequestRanks;
+            const amount = request.params.arguments.amount ?? defaults.ruleSet.amount;
+            const increment = request.params.arguments.increment ?? defaults.ruleSet.increment;
+            const incrementMethod = request.params.arguments.incrementMethod ?? defaults.ruleSet.incrementMethod;
+            const offsetAmount = request.params.arguments.offsetAmount ?? defaults.ruleSet.offsetAmount;
+            const offsetIncrement = request.params.arguments.offsetIncrement ?? defaults.ruleSet.offsetIncrement;
+            const offsetIncrementMethod = request.params.arguments.offsetIncrementMethod ?? defaults.ruleSet.offsetIncrementMethod;
+            const enableShareOptions = request.params.arguments.enableShareOptions ?? defaults.ruleSet.enableShareOptions;
+            const shareOptionsType = request.params.arguments.shareOptionsType ?? defaults.ruleSet.shareOptionsType;
+            const shareAnchor = request.params.arguments.shareAnchor ?? defaults.ruleSet.shareAnchor;
+            const customSharingAmount = request.params.arguments.customSharingAmount ?? defaults.ruleSet.customSharingAmount;
+            const customSharingMethod = request.params.arguments.customSharingMethod ?? defaults.ruleSet.customSharingMethod;
+            const applyCeilingOnlyToAnchor = request.params.arguments.applyCeilingOnlyToAnchor ?? defaults.ruleSet.applyCeilingOnlyToAnchor;
+            const applyFloorOnlyToAnchor = request.params.arguments.applyFloorOnlyToAnchor ?? defaults.ruleSet.applyFloorOnlyToAnchor;
+            const floorPricingMethod = request.params.arguments.floorPricingMethod ?? defaults.ruleSet.floorPricingMethod;
+            const ceilingPricingMethod = request.params.arguments.ceilingPricingMethod ?? defaults.ruleSet.ceilingPricingMethod;
+            const noCompPricingMethod = request.params.arguments.noCompPricingMethod ?? defaults.ruleSet.noCompPricingMethod;
             const args = {
                 productionId: productionId,
                 name: name,
@@ -151,14 +157,24 @@ class CreatePricingGroupTool {
                     noCompPricingMethod: noCompPricingMethod
                 },
                 marketGroupCriteria: {
-                    sections: []
+                    sections: defaults?.marketGroupCriteria?.sections ?? [],
+                    validSplitsIncludeV2: defaults?.marketGroupCriteria?.validSplitsIncludeV2,
+                    validSplitsIncludeMax: defaults?.marketGroupCriteria?.validSplitsIncludeMax,
+                    deliveryMethodInclude: defaults?.marketGroupCriteria?.deliveryMethodInclude,
+                    attributesExclude: defaults?.marketGroupCriteria?.attributesExclude,
+                    lowerOutlierMethod: defaults?.marketGroupCriteria?.lowerOutlierMethod,
+                    lowerOutlierAmount: defaults?.marketGroupCriteria?.lowerOutlierAmount,
+                    lowerOutlierThreshold: defaults?.marketGroupCriteria?.lowerOutlierThreshold,
+                    includeSpeculativeTickets: defaults?.marketGroupCriteria?.includeSpeculativeTickets,
+                    isSplitsDynamic: defaults?.marketGroupCriteria?.isSplitsDynamic,
+                    rowRanges: defaults?.marketGroupCriteria?.rowRanges
                 },
                 pricingGroupRequestRanks: pricingGroupRequestRanks
             };
             console.error('[API] Create Pricing Group with arguments:', args);
             const response = await httpClient.post(`/v2/client/pricing-group`, args);
             if (response.status !== 200) {
-                throw new Error(`API error: ${response.statusText}`);
+                throw new Error("API error: " + response.statusText);
             }
             return { content: [{ type: 'text', text: JSON.stringify([response.data]) }] };
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-prqx-pricer",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "description": "",
   "main": "index.js",
   "bin": {

package/prompts/mcp-n8n-4.1-instructions.md

@@ -0,0 +1,37 @@
+#Role and Objective
+You are an Agent that can help ticket brokers to organize their 
+inventory in pricing groups (Creating, Editing or Deleting) or to obtaining 
+information about their current ticket groups and pricing groups existent.
+
+Please keep going until the user's command is fully completed, before ending your turn 
+and yielding back to the user. Only terminate your turn when you are sure the problem 
+is solved.
+
+You should be able to complete your tasks using only the tools provided. Is important to always
+include as first step of your execution plan checking the list of available tools and their parameters. 
+Make sure you use the tools result to gather the required data to call other tools. Don't make assumptions outside
+the data provided by the tools.
+
+Only provide to the tools relevant arguments and mandatory values. The tools will default other
+parameters with organization defaults.
+
+You MUST plan extensively the execution of the command before starting it. 
+Check the list of available tools and plan the execution of the command to minimize the number of calls.
+
+Reflect extensively on the outcomes of the previous function calls and try to use the information gathered 
+from previous calls to make better decisions.
+
+#Context
+Today's date is {{ $now }}
+
+#Instructions
+1. First step check the list of tools available and only use those for further operations
+2. Locate the information the user is looking for. Always start narrowing the productions relevant for the task
+3. Query for ticket groups and/or pricing groups as the task requires using the ProductionId(s) gathered in step 2
+4. Execute the task using Create, Update or Delete tools
+
+#Rules
+1. A ticket group can be in only one pricing group at a time
+2. By default always create pricing groups in Simulation mode unless explicitly stated for the user to be Auto Price
+3. You can not create pricing groups with ticket groups that are already assigned to another pricing group
+4. The anchor ticket in a pricing group is the ticket group with rank 0 and is mandatory to create a pricing group

package/prompts/mcp-n8n-4.1-instructions.xml

@@ -0,0 +1,20 @@
+<agentInstructions>
+    <goal>
+        Help ticket brokers to organize their inventory in pricing groups (Creating, Editing or Deleting). 
+        or to obtain information about their inventory and pricing groups existent.
+    </goal>
+    <rule>today's date is {{ $now }}</rule>
+    <rule>IMPORTANT! First step check the list of tools available and only use those for further operations</rule>
+    <rule>After querying the list of available tools you can store it in memory and don't repeat the call to list tools for every step</rule>
+    <rule>Once you determine the plan of execution of a command give the user the feedback of how you are going to proceed</rule>
+    <rule>IMPORTANT! For production search use one year in the future as maximum period if no date period is mentioned by the user</rule>
+    <rule>To get inventory or pricing groups for multiple productions you need to query for the productions first and then use the productionId to query for inventory or pricing groups related to that production</rule>
+    <rule>IMPORTANT! A ticket group can be in only one pricing group at a time</rule>
+    <rule>By default always create pricing groups in Simulation mode unless explicitly stated for the user to be Auto Price</rule>
+    <rule>IMPORTANT! You can not create pricing groups with Ticket groups that are already assigned to other pricing group</rule>
+    <rule>Query the pricing groups and validate which ticket groups are already assigned to a pricing group before creating or modifying a pricing group</rule>
+    <rule>Pricing group names must be unique per production</rule>
+    <rule>Pricing groups cannot be created without a list of pricingGroupRequestedRanks (List of ticket groups in the group ordered by rank)</rule>
+    <rule>When creating or updating pricing groups don't provide values for the NON MANDATORY fields unless user provide explicit instructions for them</rule>
+    <rule>If any of the tools fail when executing a step. Abort the execution inmediately and inform the user of the failure. Don't retry</rule>
+</agentInstructions>

package/src/tools/createPricingGroup.ts

@@ -1,7 +1,7 @@
 import { McpTool } from "../types/tool";
 import { CallToolRequest, ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
 import axios from "axios";
-import { CeilingPricingMethod, CustomSharingMethod, FloorPricingMethod, NoCompPricingMethod, PricingGroupRequest, PricingGroupRequestType, PricingGroupResponse, ShareOptionsType, TicketGroupRequestRank } from "../types/pricingGroup";
+import { CeilingPricingMethod, CustomSharingMethod, FloorPricingMethod, NoCompPricingMethod, PricingGroupRequest, PricingGroupRequestType, PricingGroupResponse, ShareOptionsType, TicketGroupOrgDefaultResponse, TicketGroupRequestRank } from "../types/pricingGroup";
 
 export class CreatePricingGroupTool implements McpTool {
     name = 'CreatePricingGroup';
@@ -106,28 +106,37 @@ export class CreatePricingGroupTool implements McpTool {
                 throw new Error('Missing arguments');
             }
 
+            const pricingGroupRequestRanks = request.params.arguments.pricingGroupRequestRanks as TicketGroupRequestRank[];
+
+            const anchorTicketGroupId = pricingGroupRequestRanks.find(rank => rank.rank === 0)?.ticketGroupId;
+            if (!anchorTicketGroupId) {
+                throw new Error('Anchor ticket group ID is required');
+            }
+
+            const defaultsResponse = await httpClient.get<TicketGroupOrgDefaultResponse>('/v1/client/org-defaults/calculate-defaults/' + anchorTicketGroupId);
+            const defaults = defaultsResponse.data;
+
             const productionId = request.params.arguments.productionId as number;
             const name = request.params.arguments.name as string;
-            const ceilingPrice = request.params.arguments.ceilingPrice as number;
-            const floorPrice = request.params.arguments.floorPrice as number;
+            const ceilingPrice = request.params.arguments.ceilingPrice as number ?? defaults.ruleSet.ceiling;
+            const floorPrice = request.params.arguments.floorPrice as number ?? defaults.ruleSet.floor;
             const pricingGroupRequestType = request.params.arguments.pricingGroupMode as PricingGroupRequestType;
-            const amount = request.params.arguments.amount as number;
-            const increment = request.params.arguments.increment as string;
-            const incrementMethod = request.params.arguments.incrementMethod as string;
-            const offsetAmount = request.params.arguments.offsetAmount as number | undefined;
-            const offsetIncrement = request.params.arguments.offsetIncrement as string | undefined;
-            const offsetIncrementMethod = request.params.arguments.offsetIncrementMethod as string | undefined;
-            const enableShareOptions = request.params.arguments.enableShareOptions as boolean | undefined;
-            const shareOptionsType = request.params.arguments.shareOptionsType as ShareOptionsType | undefined;
-            const shareAnchor = request.params.arguments.shareAnchor as boolean | undefined;
-            const customSharingAmount = request.params.arguments.customSharingAmount as number | undefined;
-            const customSharingMethod = request.params.arguments.customSharingMethod as CustomSharingMethod | undefined;
-            const applyCeilingOnlyToAnchor = request.params.arguments.applyCeilingOnlyToAnchor as boolean | undefined;
-            const applyFloorOnlyToAnchor = request.params.arguments.applyFloorOnlyToAnchor as boolean | undefined;
-            const floorPricingMethod = request.params.arguments.floorPricingMethod as FloorPricingMethod | undefined;
-            const ceilingPricingMethod = request.params.arguments.ceilingPricingMethod as CeilingPricingMethod | undefined;
-            const noCompPricingMethod = request.params.arguments.noCompPricingMethod as NoCompPricingMethod | undefined;
-            const pricingGroupRequestRanks = request.params.arguments.pricingGroupRequestRanks as TicketGroupRequestRank[];
+            const amount = request.params.arguments.amount as number ?? defaults.ruleSet.amount;
+            const increment = request.params.arguments.increment as string  ?? defaults.ruleSet.increment;
+            const incrementMethod = request.params.arguments.incrementMethod as string ?? defaults.ruleSet.incrementMethod;
+            const offsetAmount = request.params.arguments.offsetAmount as number | undefined ?? defaults.ruleSet.offsetAmount;
+            const offsetIncrement = request.params.arguments.offsetIncrement as string | undefined ?? defaults.ruleSet.offsetIncrement;
+            const offsetIncrementMethod = request.params.arguments.offsetIncrementMethod as string | undefined ?? defaults.ruleSet.offsetIncrementMethod;
+            const enableShareOptions = request.params.arguments.enableShareOptions as boolean | undefined ?? defaults.ruleSet.enableShareOptions;
+            const shareOptionsType = request.params.arguments.shareOptionsType as ShareOptionsType | undefined ?? defaults.ruleSet.shareOptionsType;
+            const shareAnchor = request.params.arguments.shareAnchor as boolean | undefined ?? defaults.ruleSet.shareAnchor;
+            const customSharingAmount = request.params.arguments.customSharingAmount as number | undefined ?? defaults.ruleSet.customSharingAmount;
+            const customSharingMethod = request.params.arguments.customSharingMethod as CustomSharingMethod | undefined ?? defaults.ruleSet.customSharingMethod;
+            const applyCeilingOnlyToAnchor = request.params.arguments.applyCeilingOnlyToAnchor as boolean | undefined ?? defaults.ruleSet.applyCeilingOnlyToAnchor;
+            const applyFloorOnlyToAnchor = request.params.arguments.applyFloorOnlyToAnchor as boolean | undefined    ?? defaults.ruleSet.applyFloorOnlyToAnchor;
+            const floorPricingMethod = request.params.arguments.floorPricingMethod as FloorPricingMethod | undefined ?? defaults.ruleSet.floorPricingMethod;
+            const ceilingPricingMethod = request.params.arguments.ceilingPricingMethod as CeilingPricingMethod | undefined ?? defaults.ruleSet.ceilingPricingMethod;
+            const noCompPricingMethod = request.params.arguments.noCompPricingMethod as NoCompPricingMethod | undefined ?? defaults.ruleSet.noCompPricingMethod;
 
             const args : PricingGroupRequest = {
                 productionId: productionId,
@@ -154,14 +163,24 @@ export class CreatePricingGroupTool implements McpTool {
                     noCompPricingMethod: noCompPricingMethod
                 },
                 marketGroupCriteria: {
-                    sections: []
+                    sections: defaults?.marketGroupCriteria?.sections ?? [],
+                    validSplitsIncludeV2: defaults?.marketGroupCriteria?.validSplitsIncludeV2,
+                    validSplitsIncludeMax: defaults?.marketGroupCriteria?.validSplitsIncludeMax,
+                    deliveryMethodInclude: defaults?.marketGroupCriteria?.deliveryMethodInclude,
+                    attributesExclude: defaults?.marketGroupCriteria?.attributesExclude,
+                    lowerOutlierMethod: defaults?.marketGroupCriteria?.lowerOutlierMethod,
+                    lowerOutlierAmount: defaults?.marketGroupCriteria?.lowerOutlierAmount,
+                    lowerOutlierThreshold: defaults?.marketGroupCriteria?.lowerOutlierThreshold,
+                    includeSpeculativeTickets: defaults?.marketGroupCriteria?.includeSpeculativeTickets,
+                    isSplitsDynamic: defaults?.marketGroupCriteria?.isSplitsDynamic,
+                    rowRanges: defaults?.marketGroupCriteria?.rowRanges
                 },
                 pricingGroupRequestRanks: pricingGroupRequestRanks
             };
             console.error('[API] Create Pricing Group with arguments:', args);
             const response = await httpClient.post<PricingGroupResponse>(`/v2/client/pricing-group`, args);
             if (response.status !== 200) {
-                throw new Error(`API error: ${response.statusText}`);
+                throw new Error("API error: " + response.statusText);
             }
             return { content: [{ type: 'text', text: JSON.stringify([response.data]) }] };
         } catch (error) {

package/src/types/pricingGroup.ts

@@ -157,5 +157,69 @@ export interface TicketGroupRequestRank{
   rank: number;
 }
 
+export interface TicketGroupOrgDefaultResponse{
+  ruleSet: {
+    ceiling?: number;
+    isCeilingOrgDefault: boolean;
+    floor?: number;
+    isFloorOrgDefault: boolean;
+    increment?: string;
+    isIncrementOrgDefault: boolean;
+    incrementMethod?: string;
+    isIncrementMethodOrgDefault: boolean;
+    amount?: number;
+    isAmountOrgDefault: boolean;
+    offsetIncrement?: string;
+    isOffsetIncrementOrgDefault: boolean;
+    offsetIncrementMethod?: string;
+    isOffsetIncrementMethodOrgDefault: boolean;
+    offsetAmount?: number;
+    isOffsetAmountOrgDefault: boolean,
+    enableShareOptions?: boolean;
+    isEnableShareOptionsOrgDefault: boolean;
+    shareOptionsType?: ShareOptionsType;
+    isShareOptionsTypeOrgDefault: boolean;
+    shareAnchor?: boolean;
+    isShareAnchorOrgDefault: boolean;
+    pricingGroupRequestType?: PricingGroupRequestType;
+    isPricingGroupRequestTypeOrgDefault: boolean;
+    floorPricingMethod?: FloorPricingMethod;
+    isFloorPricingMethodOrgDefault: boolean;
+    ceilingPricingMethod?: CeilingPricingMethod;
+    isCeilingPricingMethodOrgDefault: boolean;
+    noCompPricingMethod?: NoCompPricingMethod;
+    isNoCompPricingMethodOrgDefault: boolean;
+    customSharingAmount?: number;
+    isCustomSharingAmountOrgDefault: boolean;
+    customSharingMethod?: CustomSharingMethod;
+    isCustomSharingMethodOrgDefault: boolean;
+    applyCeilingOnlyToAnchor?: boolean;
+    isApplyCeilingOnlyToAnchorOrgDefault: boolean;
+    applyFloorOnlyToAnchor?: boolean;
+    isApplyFloorOnlyToAnchorOrgDefault: boolean
+  },
+  marketGroupCriteria?: {
+    sections?: SectionDto[],
+    validSplitsIncludeV2?: number[],
+    validSplitsIncludeMax?: boolean,
+    deliveryMethodInclude?: string[],
+    attributesExclude?: string[],
+    lowerOutlierMethod?: LowerOutlierMethod,
+    lowerOutlierAmount?: number,
+    lowerOutlierThreshold?: number,
+    includeSpeculativeTickets?: boolean,
+    isSplitsDynamic?: boolean,
+    isSectionEnabled?: boolean,
+    rowRanges?: RowRange[]
+  },
+  dynamicMarketGroupCriteria?: {
+    validSplitsV2?: {
+      splits?: number[] | null;
+      includeMax?: boolean;
+    }
+  },
+  isCeilingRequired: boolean
+}
+
 // The response for the endpoint is an array of PricingGroupResponse
 export type GetPricingGroupByProductionIdResponse = PricingGroupResponse[];