@frontlinesystems/rason-mcp-server 2026.5.1 → 2026.5.2

package/examples/rason-features/UserGuide/UGYieldManagement3.json

@@ -1,64 +1,64 @@
-{
-  "modelName": "UGYieldManagement3Example",
-  "modelDescription": "RASON Simulation Optimization Model: Running multiple parameterized simulations in UGYieldManagement2, and examining the results has given us a good deal of information about the behavior of this simulation model. However, if we take just a few more steps we can answer the question, 'How many tickets should we sell to realize the maximum expected net revenue?' By changing 'sold' from a simulation parameter to a decision variable, we can setup a simulation optimization model. See the Defining Your Stochastic Optimization chapter within the RASON User Guide for a complete discussion of this example and also the previous examples UGYieldManagement 1 and 2.",
-  "comment": "Change the modelType property to 'optimization'. If left at 'modelType':'simulation' as in UGYieldManagement 1 and 2, only a simulation will be performed, not a simulation optimization.",
-  "modelType": "optimization",
-  "modelSettings": {
-    "comment": "Replace numSimulations: 41 with simulationOptimization: True in modelSettings. Setting simulationOptimization to true will run a simulation optimization. The evolutionary engine must be selected in engineSettings below.",
-    "simulationOptimization": true,
-    "numTrials": 1000
-  },
-  "engineSettings": {
-    "comment": "In order to run a simulation optimization, you must set the engine to 'Evolutionary'. The random seed option is set to provide reproducible results.",
-    "engine": "Evolutionary",
-    "randomSeed": 1
-  },
-  "variables": {
-    "comment": "Replace parameters with variables and define sold as an integer variable (since we can't sell fractional tickets) with a lower bound of 0 (since we can't sell a negative number of tickets). We are interested in the value of this variable in the solution, so we must ask for the finalValue to be returned in the Result.",
-    "sold": {
-      "lower": 0,
-      "upper": 500,
-      "type": "integer",
-      "finalValue": []
-    }
-  },
-  "data": {
-    "comment": "The data section remains unchanged from UGYieldManagement 2.",
-    "price": {
-      "value": 200
-    },
-    "capacity": {
-      "value": 100
-    },
-    "refund_no_shows": {
-      "value": 0.5
-    },
-    "refund_overbook": {
-      "value": 1.25
-    }
-  },
-  "uncertainVariables": {
-    "comment": "The uncertainVariables section remains unchanged from UGYieldManagement 2.",
-    "no_shows": {
-      "formula": "PsiLogNormal(0.1*sold, 0.06*sold)"
-    }
-  },
-  "formulas": {
-    "comment": "The formulas section remains unchanged from UGYieldManagement 2.",
-    "show_ups": {
-      "formula": "sold - Round(no_shows, 0)"
-    },
-    "overbook": {
-      "formula": "Max(0, show_ups - capacity)"
-    }
-  },
-  "objective": {
-    "comment": "The objective section remains unchanged from UGYieldManagement 2.",
-    "revenue": {
-      "formula": "price*(sold - refund_no_shows*Round(no_shows, 0) - refund_overbook*overbook)",
-      "chanceType": "ExpVal",
-      "type": "maximize",
-      "finalValue": []
-    }
-  }
+{
+  "modelName": "UGYieldManagement3Example",
+  "modelDescription": "RASON Simulation Optimization Model: Running multiple parameterized simulations in UGYieldManagement2, and examining the results has given us a good deal of information about the behavior of this simulation model. However, if we take just a few more steps we can answer the question, 'How many tickets should we sell to realize the maximum expected net revenue?' By changing 'sold' from a simulation parameter to a decision variable, we can setup a simulation optimization model. See the Defining Your Stochastic Optimization chapter within the RASON User Guide for a complete discussion of this example and also the previous examples UGYieldManagement 1 and 2.",
+  "comment": "Change the modelType property to 'optimization'. If left at 'modelType':'simulation' as in UGYieldManagement 1 and 2, only a simulation will be performed, not a simulation optimization.",
+  "modelType": "optimization",
+  "modelSettings": {
+    "comment": "Replace numSimulations: 41 with simulationOptimization: True in modelSettings. Setting simulationOptimization to true will run a simulation optimization. The evolutionary engine must be selected in engineSettings below.",
+    "simulationOptimization": true,
+    "numTrials": 1000
+  },
+  "engineSettings": {
+    "comment": "In order to run a simulation optimization, you must set the engine to 'Evolutionary'. The random seed option is set to provide reproducible results.",
+    "engine": "Evolutionary",
+    "randomSeed": 1
+  },
+  "variables": {
+    "comment": "Replace parameters with variables and define sold as an integer variable (since we can't sell fractional tickets) with a lower bound of 0 (since we can't sell a negative number of tickets). We are interested in the value of this variable in the solution, so we must ask for the finalValue to be returned in the Result.",
+    "sold": {
+      "lower": 0,
+      "upper": 500,
+      "type": "integer",
+      "finalValue": []
+    }
+  },
+  "data": {
+    "comment": "The data section remains unchanged from UGYieldManagement 2.",
+    "price": {
+      "value": 200
+    },
+    "capacity": {
+      "value": 100
+    },
+    "refund_no_shows": {
+      "value": 0.5
+    },
+    "refund_overbook": {
+      "value": 1.25
+    }
+  },
+  "uncertainVariables": {
+    "comment": "The uncertainVariables section remains unchanged from UGYieldManagement 2.",
+    "no_shows": {
+      "formula": "PsiLogNormal(0.1*sold, 0.06*sold)"
+    }
+  },
+  "formulas": {
+    "comment": "The formulas section remains unchanged from UGYieldManagement 2.",
+    "show_ups": {
+      "formula": "sold - Round(no_shows, 0)"
+    },
+    "overbook": {
+      "formula": "Max(0, show_ups - capacity)"
+    }
+  },
+  "objective": {
+    "comment": "The objective section remains unchanged from UGYieldManagement 2.",
+    "revenue": {
+      "formula": "price*(sold - refund_no_shows*Round(no_shows, 0) - refund_overbook*overbook)",
+      "chanceType": "ExpVal",
+      "type": "maximize",
+      "finalValue": []
+    }
+  }
 }

package/out/index.cjs

@@ -309,7 +309,7 @@ Data flow:`);for(let a of o)t.push(`  ${a}`)}return{lines:t,observations:r}}func
 ### Structure`),t.push(...a.lines),a.observations.length>0){t.push(`
 ### Observations`);for(let x of a.observations)t.push(`- ${x}`)}let s=new Set(["modelName","modelDescription","modelType","modelSettings","comment","variables","constraints","objective","uncertainVariables","uncertainFunctions","formulas","data","datasources","datasets","estimator","transformer","fittedModel","weakLearner","preProcessor","actions","decisionTables","boxFunctions","boxIterators","typeDefs","flowName","workflowName","flowDescription","workflowDescription","engineSettings","indexSets","parameters","evaluations","contexts"]),l=Object.keys(e).filter(x=>{if(s.has(x))return!1;let S=e[x];return!(S&&typeof S=="object"&&!Array.isArray(S)&&"modelName"in S)}),d=[],p=Ke(e.engineSettings);p&&d.push(`engineSettings (${p})`);let f=Ke(e.indexSets);f&&d.push(`indexSets (${f})`);let g=Ke(e.parameters);g&&d.push(`parameters (${g})`);let y=Ke(e.evaluations);y&&d.push(`evaluations (${y})`);let v=Ke(e.contexts);return v&&d.push(`contexts (${v})`),(d.length>0||l.length>0)&&(t.push(`
 ### Other sections`),d.length>0&&t.push(d.join(" | ")),l.length>0&&t.push(`Unrecognized: ${l.join(", ")}`)),t.join(`
-`)}function OR(e){e.registerTool("describe_model",{title:"Analyze RASON Model",description:"Analyze and classify a RASON model: reliably detect model type and subtype (optimization \u2014 LP, QP, MIP, stochastic, chance-constrained; simulation; datamining \u2014 classification, regression, clustering; calculation \u2014 decision tables, box functions; multi-stage flow), inventory and classify components (variable types, constraint types, distribution families, ML pipelines, inter-stage data flow), and identify issues (missing result requests, absent validation data, empty output sections). Provides deterministic RASON-specific analysis beyond what raw JSON inspection reveals. Call whenever the user asks about, discusses, or works with a RASON model \u2014 whether open in the editor, referenced as a file, provided inline, or stored on the RASON server.",annotations:{readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0,openWorldHint:!0},inputSchema:I.object({model:I.record(I.string(),I.unknown()).optional().describe("The RASON model as a JSON object. Mutually exclusive with rason_model_path and name_or_id."),rason_model_path:I.string().optional().describe("Path to a file containing a RASON model. Mutually exclusive with model and name_or_id."),name_or_id:I.string().optional().describe("Name or ID of an existing model on the RASON account. The model will be fetched and analyzed. Mutually exclusive with model and rason_model_path.")})},async t=>{let{model:r,rason_model_path:i,name_or_id:n}=t,o=[r,i,n].filter(l=>l!==void 0).length;if(o===0)throw new Error("Must provide one of: model, rason_model_path, or name_or_id.");if(o>1)throw new Error("Provide only one of: model, rason_model_path, or name_or_id.");let a;if(r)a=r;else if(i){let l=await sn(i);try{a=JSON.parse(l)}catch(d){throw new Error(`Failed to parse JSON from ${i}: ${d instanceof SyntaxError?d.message:"unknown error"}. The file may contain syntax errors or incomplete JSON. Read the file directly to inspect and fix the content.`)}}else{let d=(await tt("GET",`/model/${encodeURIComponent(n)}`)).content[0].text;try{a=JSON.parse(d)}catch(p){throw new Error(`Failed to parse model response for "${n}": ${p instanceof SyntaxError?p.message:"unknown error"}. Use get_model to retrieve the raw content and inspect it directly.`)}}return{content:[{type:"text",text:tF(a)}]}})}var NR=process.env.RASON_EXAMPLES_DIR||AR.default.resolve(__dirname,"../examples"),Bi=new qm({name:"rason-mcp-server",version:"2026.5.1"},{instructions:`This MCP server connects to Frontline Systems' RASON REST API (endpoint: https://rason.net, web app: https://rason.com). RASON (RESTful Analytic Solver Object Notation) is a JSON-based modeling language created by Frontline Systems, Inc. (https://www.solver.com), the creator of the Excel Solver, for defining and solving analytical models via a REST API.
+`)}function OR(e){e.registerTool("describe_model",{title:"Analyze RASON Model",description:"Analyze and classify a RASON model: reliably detect model type and subtype (optimization \u2014 LP, QP, MIP, stochastic, chance-constrained; simulation; datamining \u2014 classification, regression, clustering; calculation \u2014 decision tables, box functions; multi-stage flow), inventory and classify components (variable types, constraint types, distribution families, ML pipelines, inter-stage data flow), and identify issues (missing result requests, absent validation data, empty output sections). Provides deterministic RASON-specific analysis beyond what raw JSON inspection reveals. Call whenever the user asks about, discusses, or works with a RASON model \u2014 whether open in the editor, referenced as a file, provided inline, or stored on the RASON server.",annotations:{readOnlyHint:!0,destructiveHint:!1,idempotentHint:!0,openWorldHint:!0},inputSchema:I.object({model:I.record(I.string(),I.unknown()).optional().describe("The RASON model as a JSON object. Mutually exclusive with rason_model_path and name_or_id."),rason_model_path:I.string().optional().describe("Path to a file containing a RASON model. Mutually exclusive with model and name_or_id."),name_or_id:I.string().optional().describe("Name or ID of an existing model on the RASON account. The model will be fetched and analyzed. Mutually exclusive with model and rason_model_path.")})},async t=>{let{model:r,rason_model_path:i,name_or_id:n}=t,o=[r,i,n].filter(l=>l!==void 0).length;if(o===0)throw new Error("Must provide one of: model, rason_model_path, or name_or_id.");if(o>1)throw new Error("Provide only one of: model, rason_model_path, or name_or_id.");let a;if(r)a=r;else if(i){let l=await sn(i);try{a=JSON.parse(l)}catch(d){throw new Error(`Failed to parse JSON from ${i}: ${d instanceof SyntaxError?d.message:"unknown error"}. The file may contain syntax errors or incomplete JSON. Read the file directly to inspect and fix the content.`)}}else{let d=(await tt("GET",`/model/${encodeURIComponent(n)}`)).content[0].text;try{a=JSON.parse(d)}catch(p){throw new Error(`Failed to parse model response for "${n}": ${p instanceof SyntaxError?p.message:"unknown error"}. Use get_model to retrieve the raw content and inspect it directly.`)}}return{content:[{type:"text",text:tF(a)}]}})}var NR=process.env.RASON_EXAMPLES_DIR||AR.default.resolve(__dirname,"../examples"),Bi=new qm({name:"rason-mcp-server",version:"2026.5.2"},{instructions:`This MCP server connects to Frontline Systems' RASON REST API (endpoint: https://rason.net, web app: https://rason.com). RASON (RESTful Analytic Solver Object Notation) is a JSON-based modeling language created by Frontline Systems, Inc. (https://www.solver.com), the creator of the Excel Solver, for defining and solving analytical models via a REST API.
 
 RASON model types:
 - Optimization \u2014 linear, mixed-integer, nonlinear, conic, quadratic, stochastic; powered by Gurobi, XPRESS, MOSEK, KNITRO engines

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@frontlinesystems/rason-mcp-server",
-  "version": "2026.5.1",
-  "description": "MCP server for RASON — build, analyze, and solve optimization, simulation, data science, and decision models",
+  "version": "2026.5.2",
+  "mcpName": "io.github.frontlinesystems/rason-mcp-server",
+  "description": "Build, solve, and analyze RASON optimization, simulation, data science, and decision models",
   "author": "Frontline Systems (https://www.solver.com)",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {