@frontlinesystems/rason-mcp-server 2026.5.0

package/LICENSE

@@ -0,0 +1,35 @@
+This SOFTWARE LICENSE (the "License") constitutes a legally binding agreement between Frontline Systems, Inc. ("Frontline" or "Licensor") and the individual or organization ("Licensee") acquiring the right to use certain computer program products offered by Frontline (the "Software"), in exchange for Licensee’s payment to Frontline (the "Fees").  This License governs the Software as installed for ‘desktop’ Use on a personal computer; and as installed on servers operated by Frontline for ‘cloud’ Use, where portions of the Software may be executed on the server or downloaded to a personal computer through a web browser or other application (including but not limited to desktop Excel).  Unless replaced by a separate written agreement signed by an officer of Frontline, this License shall govern Licensee's use of the Software. BY DOWNLOADING, ACCEPTING DELIVERY OF, INSTALLING, INSERTING, OR USING THE SOFTWARE, LICENSEE AGREES TO BE BOUND BY ALL TERMS AND CONDITIONS OF THIS LICENSE.
+1. LICENSE GRANT AND TERMS.
+Grant of License:  Subject to all the terms and conditions of this License, Frontline grants to Licensee a non-exclusive, non-transferable except as provided below, personal right and license to Use the Software (as the term "Use" is defined below) for the term as provided in Section 5, with the following restrictions:
+Identity, Email and Password:  Frontline’s licenses enable one individual person to use the Software on more than one computer by identifying himself/herself with an email and password, or through another authentication system (including but not limited to Microsoft 365).  In consideration of this, Licensee agrees to provide and maintain a valid email address and password that is unique to and used only by the person who will Use the Software, whose personal first and last name is provided to Frontline.  During the term of this license, Licensee agrees that the email address will be associated with an email account where the individual Using the Software regularly receives email, and that neither Licensee nor such individual will ‘share’ or provide the email address and password to any other person.  Licensee agrees that Frontline’s willingness to grant this License is predicated on Licensee’s fulfillment of this obligation, and that evidence of Use of the Software by any other individual (for a Multi-User License, any other individual not identified to Frontline) shall constitute prima facie evidence of copyright infringement.  If Licensee is an organization, it may, on a quarterly basis, or more frequently if Frontline agrees in its sole discretion, change the named individual(s) who will Use the Software, in accordance with the terms of this License.
+Internet Access:  Licensee understands that ‘cloud’ Use of the Software, whether through a web browser or another application (such as desktop Excel), requires a continuous, reasonably high speed connection through the public Internet to servers operated by Frontline, or alternatively through Licensee’s own network to server software separately licensed from Frontline.  In the course of “cloud’ Use, Licensee’s model(s) and/or data, and device/system information about the Personal Computer where the Software is being Used, may be transmitted over the Internet or Licensee’s own network to Frontline’s server software, using commercial-grade secure protocols.
+Licensee further understands that, to support Use by one person on multiple Personal Computers, Frontline’s license management software must, from time to time, access Frontline’s servers via the public Internet, even when the Software is installed solely for ‘desktop’ Use on such Personal Computers.  The length of time that the Software will be permitted to run without Internet-based access to Frontline’s servers is a property of the license.  Licensee agrees to arrange for periodic Internet access on the Personal Computers where Licensee wishes to Use the Software.
+Personal Computers:  Each of the License types below permits Use by one named individual on one or more physical personal computers and/or virtual computers, subject to limits established by Frontline from time to time, in its sole discretion, based on its estimate of how many different computers (for example, two to four) may reasonably be used by one individual.  For a Multiple-User License as defined below, the limits established by Frontline will reflect the number of named individuals whom Licensee intends to share Use of the license.  Licensee understands that Frontline’s license management software may prevent Use of the Software on physical or virtual computers that exceed such limits.
+Server Resource Usage Limits:  For ‘cloud’ Use of the Software which involves consumption of computing resources on Frontline’s servers, each license type imposes limits on the amounts of processor (CPU) time, memory and external storage that may be used within a given time interval, as a property of the license.  Licensee understands that Frontline’s license management software may prevent further Use of a license, during a given time interval, if the limits are reached.  These limits do not apply to Use of Licensee’s own computing resources at Licensee’s own expense.
+Evaluation License and Test Runs:  If and when offered by Frontline for a limited Term determined by Frontline in its sole discretion, Licensee may Use the Software on one or more Personal Computers, but only one Personal Computer at any given time, for the purpose of evaluating suitability of the Software prior to Licensee’s purchase of another license type.  Such Use may permit only models and/or datasets of limited size, or may permit Use only to the extent needed to determine whether a model can be solved, without providing full solution information ("Test Runs").  No such Use shall imply any warranty of any kind, including suitability or fitness for a particular purpose; all warranties shall be as provided in Sections 2 through 4 of this agreement.
+Single-User License:  Upon Frontline’s receipt of payment from Licensee of the applicable Fee (not merely an order) for a "Single-User License", Licensee may install and Use the Software, for a limited Term specified as part of the license, on one or more Personal Computers, but may Use the Software only on one Personal Computer at any given time.  Irrespective of purchase order or invoice terms, Licensee has no right to Use the Software without prior payment.
+Multiple-User License:  If Licensee is an organization, it may purchase a license for Use by multiple named individuals, who may be employees, contractors or otherwise affiliated with the organization, and who are bound by written agreements to comply with Licensee’s obligations, including those in this License.  Upon Frontline’s receipt of payment from Licensee of the applicable Fee (not merely an order) for a "Multiple-User License", and receipt of a list of named individuals, each with email address, password, and personal first and last names: Licensee and/or the named individuals may install and Use the Software, for a limited Term specified as part of the license, on one or more Personal Computers, but each Multiple-User license may be Used by only one named individual on one Personal Computer at any given time.  As above, irrespective of purchase order or invoice terms, Licensee has no right to Use the Software without prior payment.
+"Use" of the Software means the use of any of its functions to define, analyze, solve (using optimization, simulation, data mining or other analytic methods) and/or obtain results for a single user-defined model at a time.  Use with more than one model concurrently, whether on one or several Personal Computers, requires more than one Single-User or Multiple-User License.  Use occurs only during the time that the computer’s processor is executing the Software; it does not include time when the Software is loaded into memory without being executed. The minimum time period for Use on any one Personal Computer shall be ten (10) minutes, but may be longer depending on the Software function used and the size and complexity of the model.
+Other License Restrictions:  The Software includes license management features that may store and communicate encoded information about the license type and term on the Personal Computer(s) and/or on Frontline’s servers; Licensee agrees that it will not attempt to alter or circumvent such license control features.  This License does not grant to Licensee the right to make copies of the Software or otherwise enable use of the Software in any manner other than as described above, by any persons or on any computers except as described above, or by any entity other than Licensee.  Licensee acknowledges that the Software and its structure, organization, and source code constitute valuable Intellectual Property of Frontline and/or its suppliers and Licensee agrees that it shall not, nor shall it permit, assist or encourage any third party to: (a) copy, modify adapt, alter, translate or create derivative works from the Software; (b) merge the Software into any other software or use the Software to develop any application or program having the same primary function as the Software; (c) sublicense, distribute, sell, use for service bureau use, lease, rent, loan, or otherwise transfer the Software; (d) "share" use of the Software with anyone else; (e) make the Software available over the Internet, a company or institutional intranet, or any similar networking technology, except as provided by Frontline; (f) reverse compile, reverse engineer, decompile, disassemble, or otherwise attempt to derive the source code for the Software; or (g) otherwise exercise any rights in or to the Software, except as permitted in this Section.
+U.S. Government:  The Software is provided with RESTRICTED RIGHTS. Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of the Commercial Computer Software - Restricted Rights at 48 CFR 52.227-19, as applicable. Contractor/manufacturer is Frontline Systems, Inc., P.O. Box 4288, Incline Village, NV 89450.
+2. ANNUAL SUPPORT.
+Limited warranty:  If Licensee has a current license subscription with Annual Support from Frontline, then Frontline warrants, during the license subscription term, that the Software covered by the subscription will perform substantially as described in the User Guide published by Frontline in connection with the Software, as such may be amended from time to time, when it is properly used as described in the User Guide, provided, however, that Frontline does not warrant that the Software will be error-free in all circumstances.  During the license subscription term, Frontline will make reasonable commercial efforts to correct, or devise workarounds for, any Software errors (failures to perform as so described) reported by Licensee, and to timely provide such corrections or workarounds to Licensee.  In the event of "force majeure" events such as natural disaster, war, terrorism, or civil disorder, including interruption or denial of Internet and/or communication services, Frontline's efforts may be subject to reasonable delays.
+If Licensee has a current license subscription with Annual Support for ‘cloud’ Use of the Software from Frontline, then Frontline also warrants, during the license subscription term, that the Software will use commercial-grade secure methods for transmission and temporary storage of Licensee’s information (including models and data), and that Frontline’s server software will delete any temporary copies of such information immediately after the conclusion of each Use.  Frontline may, but is not required to maintain a log of Uses of its client and server Software.
+Disclaimer of Other Warranties:  IF THE SOFTWARE IS COVERED BY A CURRENT LICENSE SUBSCRIPTION, THE LIMITED WARRANTY IN THIS SECTION 2 SHALL CONSTITUTE FRONTLINE'S AND ITS SUPPLIERS’ ENTIRE LIABILITY IN CONTRACT, TORT AND OTHERWISE, AND LICENSEE’S EXCLUSIVE REMEDY UNDER THIS LIMITED WARRANTY. IF THE SOFTWARE IS NOT COVERED BY A CURRENT LICENSE SUBSCRIPTION, FOR EXAMPLE IF LICENSEE PERMITS THE SOFTWARE LICENSE SUBSCRIPTION TO EXPIRE, THE LIMITED WARRANTY IN THIS SECTION 2 SHALL NOT APPLY.
+3. WARRANTY DISCLAIMER.
+EXCEPT AS PROVIDED IN SECTION 2 ABOVE, THE SOFTWARE IS PROVIDED "AS IS" AND "WHERE IS" WITHOUT WARRANTY OF ANY KIND; FRONTLINE AND, WITHOUT EXCEPTION, ITS SUPPLIERS (COLLECTIVELY, "LICENSORS") DISCLAIM ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, WITH RESPECT TO THE SOFTWARE OR ANY WARRANTIES ARISING FROM COURSE OF DEALING OR COURSE OF PERFORMANCE AND THE SAME ARE HEREBY EXPRESSLY DISCLAIMED TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW. WITHOUT LIMITING THE FOREGOING, LICENSORS DO NOT REPRESENT, WARRANTY OR GUARANTEE THAT THE SOFTWARE WILL BE ERROR-FREE, UNINTERRUPTED, SECURE, OR MEET LICENSEES’ EXPECTATIONS. LICENSORS DO NOT MAKE ANY WARRANTY REGARDING THE SOFTWARE'S RESULTS OF USE OR THAT THEY WILL CORRECT ALL ERRORS. THE LIMITED WARRANTY SET FORTH IN SECTION 2 IS EXCLUSIVE AND LICENSORS MAKE NO OTHER EXPRESS OR IMPLIED WARRANTIES OR CONDITIONS WITH RESPECT TO THE SOFTWARE, ANNUAL SUPPORT, AND/OR OTHER SERVICES PROVIDED IN CONNECTION WITH THIS LICENSE, INCLUDING, WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT.
+4. LIMITATION OF LIABILITY.
+IN NO EVENT SHALL LICENSORS HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION ANY LOST DATA, LOST PROFITS OR COSTS OF PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES), HOWEVER CAUSED AND UNDER ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE SOFTWARE OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BECAUSE SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES, THE ABOVE LIMITATION MAY NOT APPLY. NOTWITHSTANDING ANYTHING HEREIN TO THE CONTRARY, IN NO EVENT SHALL LICENSORS’ TOTAL CUMULATIVE LIABILITY IN CONNECTION WITH THIS LICENSE, THE SOFTWARE, AND ANY SUPPORT PROVIDED TO LICENSEE HEREUNDER, WHETHER IN CONTRACT OR TORT OR OTHERWISE EXCEED THE PRICE OF ONE SINGLE-USER LICENSE. FRONTLINE'S SUPPLIERS ARE INTENDED BENEFICIARIES OF THESE LIMITATIONS AND DISCLAIMERS, AND THIS LIMITATION OF LIABILITY FOR FRONTLINE AND ITS SUPPLIERS IS NOT CUMULATIVE. LICENSEE ACKNOWLEDGES THAT THIS ARRANGEMENT REFLECTS THE ALLOCATION OF RISK SET FORTH IN THIS LICENSE AND THAT LICENSORS WOULD NOT ENTER INTO THIS LICENSE WITHOUT THESE LIMITATIONS ON ITS LIABILITY. LICENSEE ACKNOWLEDGES THAT THESE LIMITATIONS SHALL APPLY NOTWITHSTANDING ANY FAILURE OF ESSENTIAL PURPOSE OF ANY LIMITED REMEDY.
+LICENSEE UNDERSTANDS AND AGREES THAT ANY RESULTS OBTAINED THROUGH LICENSEE'S USE OF THE SOFTWARE ARE ENTIRELY DEPENDENT ON LICENSEE’S DESIGN AND IMPLEMENTATION OF ITS OWN OPTIMIZATION, SIMULATION OR DATA MINING MODEL, FOR WHICH LICENSEE IS ENTIRELY RESPONSIBLE, EVEN IF LICENSEE RECEIVED ADVICE, REVIEW, OR ASSISTANCE ON MODELING FROM FRONTLINE.
+5. TERM AND TERMINATION, DISPUTES.
+Term:  The License shall become effective when Licensee first downloads, accepts delivery, installs, inserts or uses the Software, and shall continue for a limited term specified as part of the License, unless earlier terminated for breach pursuant to this Section.  As provided above, Licensee's right to use the Software under this License is expressly conditioned on Frontline's receipt of payment of Fees for the License.
+Renewal:  On the last day of the License term, unless Licensee notifies Frontline in writing to the contrary at least 30 days prior to such date, the License will renew for another term of the same duration, at Frontline's then-current Fees for such a License, and such amount will be invoiced and become due and payable by Licensee.  As provided above, Licensee's continued right to use the Software is expressly conditioned on Frontline's receipt of payment of such Fees.
+Termination:  Frontline may terminate this License if Licensee breaches any material provision of this License and does not cure such breach (provided that such breach is capable of cure) within 30 days after Frontline provides Licensee with written notice thereof.
+Disputes:  The parties desire to resolve disputes arising out of this Agreement without litigation.  Accordingly, except for an action for copyright infringement related to Licensee's unauthorized use of the Software, the parties agree to meet and negotiate in good faith to resolve any dispute arising under this Agreement, with any correspondence treated as confidential information developed for purposes of settlement and exempt from discovery and production.  If the negotiations do not resolve the dispute within 60 days, the dispute shall be submitted to binding arbitration by a single arbitrator pursuant to the Commercial Arbitration Rules of the American Arbitration Association.  Discovery shall be controlled by the arbitrator.  The arbitrator shall rule on the dispute by issuing a written opinion within 30 days after the close of hearings.  Judgment upon the award rendered by the arbitrator may be entered in any court having jurisdiction.  Each party shall bear its own costs of these procedures.
+6. GENERAL PROVISIONS.
+Proprietary Rights:  The Software is licensed, not sold; title to the Software remains with Frontline and its suppliers.  The Software and all existing and future worldwide copyrights, trademarks, service marks, trade secrets, patents, patent applications, moral rights, contract rights, and other proprietary and intellectual property rights therein ("Intellectual Property"), are the exclusive property of Frontline and/or its suppliers.  All rights in and to the Software and Frontline’s other Intellectual Property not expressly granted to Licensee in this License are reserved by Frontline.  For the Large-Scale LP/QP Solver only:  Source code is available, as part of an open source project, for portions of the Software developed by others; please contact Frontline for information if you want to obtain this source code.
+Amendments:  This License constitutes the complete and exclusive agreement between the parties relating to the subject matter hereof.  It supersedes all other proposals, understandings and all other agreements, oral and written, between the parties relating to this subject matter, including any purchase order of Licensee, any of its preprinted terms, or any terms and conditions attached to such purchase order.
+Compliance with Laws:  Licensee agrees it will not export or re-export the Software without all required United States and foreign government licenses.
+Assignment:  This License may be assigned to any entity that succeeds by operation of law to Licensor or Licensee, or that purchases all or substantially all of Licensor's or Licensee’s assets (the "Successor"), provided that the other party is notified of the transfer, and that Successor agrees to all terms and conditions of this License.
+Governing Law:  Any controversy, claim or dispute arising out of or relating to this License, shall be governed by the laws of the State of Nevada, other than such laws, rules, regulations and case law that would result in the application of the laws of a jurisdiction other than the State of Nevada.
+

package/README.md

@@ -0,0 +1,282 @@
+<!-- This file is generated. Edit docs/readme/ sources instead. -->
+
+# <img src="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/mcp-128-128-height-reduced.png" alt="Frontline Systems" height="64"> RASON MCP Server
+
+[![RASON MCP](https://img.shields.io/visual-studio-marketplace/v/FrontlineSystems.rason-mcp?label=RASON%20MCP)](https://marketplace.visualstudio.com/items?itemName=FrontlineSystems.rason-mcp)
+[![RASON MCP (npm)](https://img.shields.io/npm/v/@frontlinesystems/rason-mcp-server?label=RASON%20MCP%20%28npm%29)](https://www.npmjs.com/package/@frontlinesystems/rason-mcp-server)
+
+AI-powered platform for decision intelligence: building, analyzing, and solving optimization, simulation, data science, and decision models with RASON.
+
+<sub><i>RASON MCP Server in Claude Desktop — solving a product mix optimization model with results table, constraint utilization chart, and key insights.</i></sub>
+
+<sub><i>🔍 Click the screenshot to view full size.</i></sub>
+
+<a href="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/claude/light/opt.png"><img src="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/claude/light/opt.png" alt="RASON MCP Server in Claude Desktop — solving a product mix optimization model with results table, constraint utilization chart, and key insights" width="768"></a>
+
+### Works across all major RASON model types
+
+Click any model type to see it in action.
+
+<table>
+<tr>
+<td align="center" width="20%"><a href="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/claude/light/opt.png"><img src="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/claude/light/opt.png" width="150" height="250" alt="Optimization example in Claude Desktop"></a><br><sub><b>Optimization</b></sub></td>
+<td align="center" width="20%"><a href="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/claude/light/sim.png"><img src="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/claude/light/sim.png" width="150" height="250" alt="Simulation example in Claude Desktop"></a><br><sub><b>Simulation</b></sub></td>
+<td align="center" width="20%"><a href="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/claude/light/calc.png"><img src="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/claude/light/calc.png" width="150" height="250" alt="Decision Tables example in Claude Desktop"></a><br><sub><b>Decision Tables</b></sub></td>
+<td align="center" width="20%"><a href="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/claude/light/dm.png"><img src="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/claude/light/dm.png" width="150" height="250" alt="Data Science example in Claude Desktop"></a><br><sub><b>Data Science</b></sub></td>
+<td align="center" width="20%"><a href="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/claude/light/flow.png"><img src="https://raw.githubusercontent.com/FrontlineSystems/media/refs/heads/main/claude/light/flow.png" width="150" height="250" alt="Multi-Stage Flows example in Claude Desktop"></a><br><sub><b>Multi-Stage Flows</b></sub></td>
+</tr>
+</table>
+
+## What is RASON?
+
+[RASON](https://www.solver.com/rason) (Restful Analytic Solver® Object Notation) is a multi-purpose modeling language and decision intelligence platform by [Frontline Systems](https://www.solver.com) for building, analyzing, and solving mathematical optimization, simulation / risk analysis, and data science / machine learning models, plus business decision rules and multi-stage decision flows.
+
+You can use RASON models on your desktop with [RASON Desktop](https://www.solver.com/rason-desktop) for VS Code, Power BI Desktop and Excel Desktop; in the Azure cloud with a REST API working with Microsoft Fabric, Power BI Service and Excel for the Web; in Docker containers; and in your own app written in C/C++, C#, Java, Python, and R via Frontline's [Solver SDK](https://www.solver.com/solver-sdk-platform).
+
+RASON comes with world-class solvers for mathematical optimization, advanced probability distributions and simulation, powerful machine learning algorithms, rich DMN business rule handling, and easy-to-build multi-stage decision flows with an in-memory SQL engine.
+
+## About This MCP Server
+
+This MCP server is more than a REST API wrapper — it's a complete AI infrastructure for analytical modeling. It includes a searchable library of nearly 200 example models, templates that guide model generation, structural analysis, and solve result interpretation. An AI assistant connected to this server can help formulate a model from a business problem description, find relevant examples, explain model structure, submit it for solving, and present results in a goal-oriented way — closing the loop with suggested next steps and improvements.
+
+## What Can You Do With It?
+
+**Explore nearly 200 ready-made examples**
+
+> "Find examples of portfolio optimization"
+>
+> "Show me a vehicle routing model I can start from"
+>
+> "What simulation examples are available?"
+
+**Build models from templates**
+
+> "Create a new linear optimization model"
+>
+> "Give me a decision table template"
+>
+> "Start a simulation model from scratch"
+
+**Analyze and understand models**
+
+> "Describe the structure of this model — what type is it?"
+>
+> "What variables and constraints does this optimization model have?"
+>
+> "Explain what this model is doing"
+
+**Solve optimization, simulation, data science & decision models**
+
+> "Solve this product mix model and show me the optimal allocation"
+>
+> "Run a Monte Carlo simulation on this risk model"
+>
+> "Evaluate this decision table with the following inputs"
+>
+> "Train a classification model to predict customer churn"
+
+**Go beyond simple commands**
+
+> "I have a scheduling problem with 8 employees and shift constraints — build me an optimization model, solve it, and show the schedule as a table"
+>
+> "Find a portfolio optimization example, adapt it for 3 assets with a 15% risk budget, solve it, and summarize the allocation"
+>
+> "Submit my model for solve, keep polling status, and when it's done show results in a table with key insights"
+>
+> "This model is infeasible — run diagnostics and suggest which constraints to relax"
+
+**Manage models in your RASON account**
+
+> "List all my optimization models"
+>
+> "Upload this RASON model with its CSV data files"
+>
+> "Create a new version of 'supply-chain' and set it as the champion"
+>
+> "Clean up all old versions of 'product-mix' — keep only the champion"
+
+## Getting Started
+
+Prerequisites:
+
+- Node.js 18 or later
+- A RASON bearer token only if you want to solve models, run diagnostics, or manage cloud models
+
+Add the server to your MCP client's configuration. For most clients, use this server entry under the client's MCP server map:
+
+```json
+{
+  "mcpServers": {
+    "rason": {
+      "command": "npx",
+      "args": ["-y", "@frontlinesystems/rason-mcp-server"],
+      "env": {
+        "RASON_BEARER_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+You can omit `env` or `RASON_BEARER_TOKEN` to use the no-account tools only.
+
+Where to put this depends on your client:
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+Add the config above to your config file:
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+See [Claude Desktop MCP setup](https://modelcontextprotocol.io/docs/develop/connect-local-servers) for details.
+
+</details>
+
+<details>
+<summary><strong>VS Code (Copilot Chat)</strong></summary>
+
+Create or update an MCP configuration file such as `.vscode/mcp.json` in your workspace or the user-level MCP config, using VS Code's `"servers"` shape:
+
+```json
+{
+  "servers": {
+    "rason": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@frontlinesystems/rason-mcp-server"],
+      "env": {
+        "RASON_BEARER_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+Or install the [RASON MCP Server extension](https://marketplace.visualstudio.com/items?itemName=FrontlineSystems.rason-mcp) for automatic setup.
+
+See [VS Code MCP setup](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) for details.
+
+</details>
+
+<details>
+<summary><strong>Claude Code</strong></summary>
+
+```bash
+claude mcp add --transport stdio --env RASON_BEARER_TOKEN=your_token_here rason -- npx -y @frontlinesystems/rason-mcp-server
+```
+
+You can omit `--env RASON_BEARER_TOKEN=...` to use only the no-account tools.
+
+See [Claude Code MCP setup](https://code.claude.com/docs/en/mcp) for details.
+
+</details>
+
+<details>
+<summary><strong>Cursor</strong></summary>
+
+Add the config above under `"mcpServers"` in `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global).
+
+See [Cursor MCP setup](https://cursor.com/docs/mcp) for details.
+
+</details>
+
+<details>
+<summary><strong>Windsurf</strong></summary>
+
+Add the config above under `"mcpServers"` in `~/.codeium/windsurf/mcp_config.json`.
+
+See [Windsurf MCP setup](https://docs.windsurf.com/windsurf/cascade/mcp) for details.
+
+</details>
+
+<details>
+<summary><strong>Other MCP Clients</strong></summary>
+
+This server works with any MCP-compatible client over stdio. Configure it with:
+- **Command**: `npx`
+- **Arguments**: `-y @frontlinesystems/rason-mcp-server`
+- **Transport**: stdio
+- **Environment variables**: See [Configuration](#configuration) below
+
+</details>
+
+## Works Without a RASON Account
+
+Example search, model templates, model analysis, and RASON info tools work without credentials. You can explore the full example library and build models before signing up. A [RASON account](https://rason.com) is needed only for solving models and managing models in the cloud.
+
+## Configuration
+
+Set these environment variables in your MCP client config (see [Getting Started](#getting-started) above):
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `RASON_BEARER_TOKEN` | — | Auth token from your [RASON account](https://rason.com). Required for solving and model management. |
+| `RASON_SERVER_URL` | `https://rason.net` | RASON server URL. |
+| `RASON_RESULT_ARRAY_LIMIT` | `25` | Max array/dataFrame rows before summarizing |
+| `RASON_RESULT_SIZE_LIMIT` | `50000` | Max result characters before truncating |
+| `RASON_REQUEST_TIMEOUT` | `300000` | Request timeout in ms (default: 5 minutes) |
+
+## Tools
+
+<details>
+<summary><strong>All 20 tools</strong></summary>
+
+### Examples & Templates
+
+- **search_examples** — Search ~200 example models by keyword or type (optimization, simulation, datamining/data science, calculation/decision tables, flow/multi-stage pipelines)
+- **get_example** — Retrieve a specific example model with full definition and metadata
+- **get_model_template** — Get a bare JSON scaffold for a model type: blank, optimization, simulation, sim-optimization, data-science, workflow, decision-table, power-bi
+
+### Analysis
+
+- **describe_model** — Analyze model structure: type/subtype detection, component inventory, issue identification
+- **about_rason** — RASON capabilities, model types, Frontline Systems ecosystem, and server info
+
+### Solving
+
+- **solve_model** — Solve a model synchronously (inline RASON, RASON files, or Excel workbooks)
+- **submit_solve** — Submit a model for asynchronous solving (long-running models)
+- **get_solve_status** — Check solving status and progress
+- **get_solve_result** — Retrieve the result once solving is complete
+- **stop_solve** — Stop a running solve (intermediate results may be available)
+
+### Diagnostics
+
+- **diagnose_model** — Run diagnostics synchronously (useful for infeasible/unbounded optimization models)
+- **submit_diagnose** — Submit for asynchronous diagnostics
+
+### Model Management
+
+- **list_models** — List models in your account with optional filters by type and kind
+- **get_model** — Retrieve a model definition (RASON JSON)
+- **post_model** — Create a new model from a RASON JSON definition
+- **post_model_with_files** — Upload a model with file attachments (RASON + data files, or Excel)
+- **put_model** — Update an existing model or create a new version
+- **put_model_with_files** — Update a model with file attachments
+- **set_champion** — Set or unset the champion (default) version of a model
+- **delete_model** — Delete models with flexible filtering by kind, type, and force option
+
+</details>
+
+## Prompts & Resources
+
+The server includes **12 guided prompts** for common workflows (solving, uploading, diagnostics, model management) and **2 resources** — a live model catalog and a browsable example library reference.
+
+## Disclaimer
+
+This software is provided "as is", without warranty of any kind. Use of this MCP server involves interaction with external cloud services (RASON REST API). You are responsible for reviewing actions before they are executed, managing your own credentials securely, and ensuring compliance with applicable terms of service. Before uploading models, files, or data to RASON cloud services, review Frontline Systems' [Terms and Conditions](https://www.solver.com/terms-conditions) and [Privacy Policy](https://www.solver.com/privacy). AI-generated model formulations and interpretations of solve results should be validated before use in production or decision-making.
+
+## License
+
+Copyright © 2026 Frontline Systems, Inc. All rights reserved. This is proprietary software; no part may be reproduced, distributed, or modified without prior written permission from Frontline Systems. Use is governed by the [Frontline Systems Software License](https://github.com/FrontlineSystems/media/blob/main/LICENSE). For licensing inquiries, contact [Frontline Systems](https://www.solver.com/how-may-we-help-you).
+
+## Feedback and Support
+
+This software is developed and maintained by **Frontline Systems, Inc.** For questions, feedback, or licensing inquiries, please contact your Frontline representative or reach us at [solver.com/how-may-we-help-you](https://www.solver.com/how-may-we-help-you).
+
+## Links
+
+- [RASON Portal](https://rason.com) — Create a free account, manage models, documentation
+- [Frontline Systems](https://www.solver.com) — The company behind RASON and Analytic Solver
+- [MCP Protocol](https://modelcontextprotocol.io) — Learn about the Model Context Protocol

package/examples/EXAMPLES_REFERENCE.md

@@ -0,0 +1,128 @@
+# RASON Example Library
+
+**200+ example models** demonstrating RASON's optimization, simulation, data science, and decision modeling capabilities.
+
+Use the `search_examples` tool to find specific models, then `get_example` to retrieve the full source.
+
+---
+
+## Optimization (61 models)
+
+**Linear Programming (10 models)**
+Product mix, inventory management, resource allocation, scheduling
+Data integration: CSV, Excel, SQL database binding
+
+**Non-Linear Optimization (3 models)**
+Airline hub location, network design, facility placement
+
+**Conic Optimization (5 models)**
+Second-order cone problems, robust optimization
+
+**Quadratic Optimization (2 models)**
+Portfolio optimization, risk management, variance minimization
+
+**Non-Smooth Optimization (1 model)**
+Inventory optimization with non-smooth objectives
+
+**Stochastic Optimization (6 models)**
+Optimization under uncertainty, chance constraints, recourse models, robust optimization
+
+**Data Binding Examples (9 models)**
+Optimization with Excel, CSV, SQL data sources, inline tables, pivot tables
+
+**Other Optimization Models (25 models)**
+Various optimization problems and techniques
+
+---
+
+## Simulation (16 models)
+
+Monte Carlo simulation, stochastic processes, probability models
+Examples: College fund growth, GBM simulation, candy store sales, yield management
+Integration with optimization (simulation-optimization)
+
+---
+
+## Calculation (32 models)
+
+**Decision Tables (10+ models)**
+Hit policies (unique, first, priority, collect), expressions, date/time handling, data sources
+Loan recommendation and strategy examples
+
+**Box Functions & Iterators (8+ models)**
+Custom box functions, FEEL expressions, FOR/SOME/EVERY loops
+Lambda functions, type definitions
+
+**Other Calculations (14+ models)**
+Various calculation models and formulas
+
+---
+
+## Data Science (74 models)
+
+**Classification (7 models)**
+Decision trees, neural networks, logistic regression, discriminant analysis, naive bayes, nearest neighbors
+
+**Classification Ensembles (6 models)**
+Bagging, boosting, random forests
+
+**Regression (5 models)**
+Linear regression, nearest neighbors, decision trees
+
+**Clustering (2 models)**
+K-means, hierarchical clustering
+
+**Time Series Forecasting (8 models)**
+ARIMA, exponential smoothing, Holt-Winters (additive/multiplicative/no-trend), moving average, lag analysis
+
+**Feature Selection (3 models)**
+Univariate selection, wrapper methods (linear and logistic)
+
+**Text Mining (3 models)**
+TF-IDF, latent semantic analysis
+
+**Transformation (16 models)**
+PCA, canonical variate analysis, rescaling, binning, partitioning, sampling, stratified sampling, one-hot encoding, category reduction, missing data handling, oversampling
+
+**Affinity Analysis (1 model)**
+Association rules, market basket analysis
+
+**Data Sources (7 models)**
+CSV, JSON, Excel, MS Access, MS SQL, ODATA, ODBC connections
+
+**Scoring (12 models)**
+Apply fitted models using JSON or PMML formats
+Classifiers, regressors, forecasters, transformers, clusterers
+
+**Other Data Science Models (4+ models)**
+Simulation, summarization, and other analytics techniques
+
+---
+
+## Decision Flows (6 models)
+
+Multi-stage pipelines and workflows
+Examples: optimization→simulation, data science→calculation, scoring workflows
+Inline and reusable stage patterns
+
+---
+
+## RASON Feature Demos (40 models)
+
+Language feature examples and reference guide demonstrations
+
+**Arrays (5 models)**
+Parallel arrays, indexed arrays, non-parallel arrays, SUM aggregates
+
+**Loops (4 models)**
+Loop syntax, nested loops, if-then-else, while statements
+
+**Data Filtering (1 model)**
+Using filters with arrays and tables
+
+**Box Functions & Iterators (8+ models)**
+Box iterator examples, FEEL expressions, custom functions, lambda functions
+
+**Reference & User Guide Examples (22+ models)**
+Examples from RASON Reference Guide and User Guide
+Comprehensive demonstrations of RASON language features and syntax

package/examples/Optimization/Conic/AirlineHubConic.json

@@ -0,0 +1,112 @@
+{
+  "modelName": "AirlineHubConicExample",
+  "modelDescription": "Conic Constraint Optimization Example RASON Model: This model minimizes the distance between several regional airports and a proposed hub location. In the original AirlineHub models, found within the Nonlinear examples, the Pythagorean Theorem was used to calculate the distance of each city to the proposed airport hub location.  Since this distance calculation was nonlinear, a nonlinear engine was required to solve the model, such as the Standard GRG Engine.  In this example, however, we will use 6 conic constraints (one for each regional airline location) to calculate the distance between the airline hub and the regional airports. Removing the nonlinear functions and replacing them with conic constraints results in a SOCP Convex model which can be solved faster and more reliably with the SOCP engine.",
+  "modelType": "optimization",
+  "engineSettings": {
+    "comment": "Since this model uses conic constraints, the SOCP Barrier engine must be selected.  A simple example of a conic constraint is a non-negativity constraint on the decision variables.  A non-negativity constraint simply means that all variables must be greater than 0.  In this model, the variable blocks F21:F26, G21:G26 and H21:H26 must lie within a 2nd order cone (also called a Lorentz cone or 'ice cream cone'). This cone places a bound on the L2-norm of the vector of decision variables.  In this model, if the variables in cells F21:F26, G21:G26 and H21:H26 lie within a code, then FX >= SQRT(SUMSQ(GX:HX))",
+    "engine": "SOCP Barrier"
+  },
+  "variables": {
+    "comment": "There are 21 total variables in the model.",
+    "x": {
+      "comment": "The x variable represents the x coordinate of the proposed hub location.",
+      "value": 1.0,
+      "finalValue": []
+    },
+    "y": {
+      "comment": "The y variable represents the y coordinate of the proposed hub location.",
+      "value": 1.0,
+      "finalValue": []
+    },
+    "z": {
+      "comment": "The z variable is an artificial variable that will be used to 'squash' or incentivize RASON Decision Services to find a location for the hub that minimizes the distances between the hub and each regional airport.",
+      "value": 1.0,
+      "finalValue": []
+    },
+    "f21:f26": {
+      "comment": "These variables are new to the conic formulation.  These are required to setup the conic constraints, see below. Each set of three variables, for example F21:H21, must belong to a second order cone constraint (F21:H21 = conic) which can be rewritten as F21 >= SQRT(SUMSQ(G21:H21). The 6 conic constraints replace the nonlinear distance calculation in the C1, C2, C3, C4, C5 and C6 constraints in the AirlineHub model.",
+      "value": 1.0
+    },
+    "g21:g26": {
+      "comment": "These variables are new to the conic formulation.  These are required to setup the conic constraints, see below.",
+      "value": 1.0
+    },
+    "h21:h26": {
+      "comment": "These variables are new to the conic formulation.  These are required to setup the conic constraints, see below.",
+      "value": 1.0
+    }
+  },
+  "data": {
+    "comment": "The data section (optional) can be used to setup constant arrays or generate formulas to be utilized in the constraints and objective. ",
+    "corx": {
+      "comment": "This array contains the x coordinates for each regional airport.",
+      "dimensions": [ 6 ],
+      "value": [ 1, 0.5, 2, 2, 2, 0.5 ]
+    },
+    "cory": {
+      "comment": "This array contains the y coordinates for each regional airport.",
+      "dimensions": [ 6 ],
+      "value": [ 4, 3, 4, 2, 5, 6 ]
+    }
+  },
+  "constraints": {
+    "dx": {
+      "comment": "The differences between the x coordinates of the hub and each regional airport. This constraint is set equal to the new variables, G21:G26.",
+      "dimensions": [ 6 ],
+      "formula": "corx - x - g21:g26",
+      "lower": 0,
+      "upper": 0
+    },
+    "dy": {
+      "comment": "The differences between the y coordinates of the hub and each regional airport. This constraint is set equal to the new variables, H21:H26.",
+      "dimensions": [ 6 ],
+      "formula": "cory - y - h21:h26",
+      "lower": 0,
+      "upper": 0
+    },
+    "dz": {
+      "comment": "The effect of this constraint, coupled with the minimization of the z artificial variable, results in the artificial variable becoming equal to the maximum value in the f21:f26 variable array, in the final solution",
+      "dimensions": [ 6 ],
+      "formula": "f21:f26 - z",
+      "upper": 0
+    },
+    "cone1": {
+      "comment": "This comment applies to all 6 cone constraints, below.  Each set of 3 variables for example, F21, G21 and H21, must belong to a second order cone constraint which can be rewritten as F21 >= SQRT(SumSQ(G21:H21). These 6 conic constraints replace the nonlinear distance constraints in the original AirlineHub example.",
+      "value": "f21:h21",
+      "type": "cone"
+    },
+    "cone2": {
+      "comment": "cone constraint for f22, g22 and h22",
+      "value": "f22:h22",
+      "type": "cone"
+    },
+    "cone3": {
+      "comment": "cone constraint for f23, g23 and h23",
+      "value": "f23:h23",
+      "type": "cone"
+    },
+    "cone4": {
+      "comment": "cone constraint for f24, g24 and h24",
+      "value": "f24:h24",
+      "type": "cone"
+    },
+    "cone5": {
+      "comment": "cone constraint for f25, g25 and h25",
+      "value": "f25:h25",
+      "type": "cone"
+    },
+    "cone6": {
+      "comment": "cone constraint for f26, g26 and h26",
+      "value": "f26:h26",
+      "type": "cone"
+    }
+  },
+  "objective": {
+    "obj": {
+      "comment": "The objective, the z variable, is a decision variable being minimized. The effect of this variable being minimized, coupled with the dz constraint, results in the dz variable being equal to the max of F21:F26 variable values in the final solution.",
+      "formula": "z",
+      "type": "minimize",
+      "finalValue": []
+    }
+  }
+}