lingo-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@lingo-mcp solve this LINGO model: MAX = 3*X1 + 4*X2 + 2*X3; X1 + 2*X2 + X3 <= 30; X2 <= 24; X3 <= 30;"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
lingo-mcp
An MCP server that lets an AI assistant solve optimization models with a locally installed LINGO 11, and read the results back as structured data.
It drives LINGO's own command-line executable (RunLingo.exe) with a generated
command script, so answers come from the real LINGO solver — not from a
reimplementation.
Zero npm dependencies (plain Node.js, stdio JSON-RPC)
Structured output: status, objective, variable values, reduced costs, row slacks, dual prices
Recognises infeasible and unbounded outcomes instead of silently reporting a number
Verified against an independent exact-arithmetic LP solver in the test suite
Requirements
Node.js 18 or newer
LINGO 11 installed. The server looks at, in order:
$LINGO_HOME,C:\LINGO11,D:\LINGO11,C:\Program Files\LINGO11,C:\Program Files (x86)\LINGO11,C:\LINGO,D:\LINGO, then the registry.
Only the solver is required. Lingo11.exe (the GUI) is not used; if it is missing
the server still works, it just reports gui: null.
Related MCP server: HiGHS MCP Server
Install
git clone https://github.com/Han-maker-wp/lingo-mcp.git
cd lingo-mcp
node src/index.js # run it
npm test # 13 end-to-end tests against your local LINGORegister with an MCP client
ZCode / Claude Desktop / mcporter — add to your MCP config:
{
"mcpServers": {
"lingo": {
"command": "node",
"args": ["C:\\path\\to\\lingo-mcp\\src\\index.js"]
}
}
}If LINGO is installed somewhere unusual, set the LINGO_HOME environment
variable to that directory.
Tools
lingo_solve
Solve a model and return the structured solution. Pass model (inline LINGO
source) or file_path (a .lng / .lg4 file).
// arguments
{
"model": "MAX = 3*X1 + 4*X2 + 2*X3;\nX1 + 2*X2 + X3 <= 30;\nX2 <= 24;\nX3 <= 30;",
"nonzero_only": false, // optional: report only nonzero variables
"timeout_ms": 120000 // optional
}// result
{
"ok": true,
"status": "optimal", // optimal | local_optimal | feasible
// | infeasible | unbounded | no_solution | null
"objective": 90,
"infeasibilities": 0,
"iterations": 0,
"variables": [ { "name": "X1", "value": 30, "reducedCost": 0 }, ... ],
"rows": [ { "row": 1, "slackOrSurplus": 90, "dualPrice": 1 }, ... ],
"errors": [],
"report": "...raw LINGO output..."
}ok is true only when a usable solution came back. An infeasible or unbounded
model is reported as such, with ok: false — the tool never invents an optimum.
Row numbering follows LINGO: row 1 is the objective function, constraints start at row 2.
lingo_run_commands
Run arbitrary LINGO command-window commands after loading a model, for analyses
lingo_solve does not structure (sensitivity, solution picture, raw rows).
{ "model": "MAX = X + 2*Y;\nX + Y <= 4;\nX - Y >= 3;",
"commands": ["GO", "RANGE 1", "PICTURE 1"] }lingo_status
Detected install path, LINGO version, license expiry, and solver memory.
lingo_list_samples
List the example models in the LINGO Samples folder, with an optional filter.
Notes on driving LINGO 11
These are the behaviours that make scripted LINGO 11 work, each learned the hard
way. They are encoded in src/lingo.js.
RunLingo.exetakes a command script, not a model.runlingo <script.ltf>executes a LINGO command script. The command set is a small subset of the GUI command window:MODEL,TAKE,GO,SOLU,NONZ,DIVERT,RVRT,LOOK,RANGE,PICTURE,DUAL,SMPS,QUIT, and so on. There is noOPENand noSOLVE; loading a file isTAKEand solving isGO.Command scripts must use CRLF line endings. With bare LF, LINGO reads the whole file as one line and rejects every command as invalid.
A model file must start with
MODEL:and end withEND. Without theMODEL:header, LINGO 11.0 fails to parse the objective line with "Invalid input. A syntax error has occurred" — and if the model is left completely empty, it instead reports the misleading "The model generator ran out of memory". This server wraps bare models automatically.MODELis for keyboard input, not files. It reads a model from stdin. Using it on a redirected stdin fails; useTAKEfor files.Paths in scripts and models may use forward slashes. Backslashes are fine but must be written literally — an escaped
\a,\nor similar in the generating layer turns into a control character and LINGO reports a misleading "Unable to open file".DIVERTmust come before the commands whose output you want to keep. Output produced beforeDIVERTgoes to the terminal, not the report file.The solution report is printed twice — once as part of
GO, once forSOLU. The parser de-duplicates it, sovariablesandrowsare not doubled.The evaluation build has a size ceiling (150 constraints, 300 variables, 30 integer variables). Larger models fail with error 108; that is a licensing limit, not a bug in this server.
The GUI (
Lingo11.exe) needs the Visual C++ 2005 runtime (Microsoft.VC80.CRTandMicrosoft.VC80.MFC, x86). It refuses to start with "its side-by-side configuration is incorrect" on a machine without them. The command-line solver has no such dependency, so this server does not need them.
Tests
npm testThe suite spawns the server over stdio exactly as an MCP client would, then
cross-checks every optimal objective against test/exact-lp.js — a small
exact-rational LP solver (vertex enumeration over BigInt fractions) written
independently of LINGO. Agreement is therefore meaningful rather than a
tautology. It also asserts that the point LINGO reports is actually feasible and
scores exactly the optimum, so a merely-feasible answer cannot pass.
License
MIT
Available Tools
4 toolslingo_list_samplesA
List the example models shipped in the LINGO Samples folder, optionally filtered by name.
Inputs: filter.
lingo_run_commandsA
Run an arbitrary sequence of LINGO command-window commands against a model and return the raw output. Use this for analyses the structured solver does not cover, e.g. ["GO", "RANGE 1", "PICTURE 1"]. Commands run after the model is loaded.
Inputs: commands (required), model, file_path, timeout_ms.
lingo_solveA
Solve a LINGO optimization model and return the structured solution (status, objective value, variable values with reduced costs, row slacks/surplus with dual prices). Accepts LINGO 11 model source inline or a path to a .lng/.lg4 file. The model may be written in plain LINGO 11 syntax; MODEL: and END are added automatically.
Inputs: model, file_path, timeout_ms, nonzero_only.
lingo_statusB
Report the detected LINGO 11 installation: path, version, license expiry, solver memory.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: lingo_solve returns structured solutions, lingo_run_commands runs raw commands as an escape hatch, lingo_status checks the installation, and lingo_list_samples lists examples. The descriptions explicitly clarify when to use the generic command runner versus the structured solver, leaving no meaningful overlap.
All names use snake_case with a consistent 'lingo_' prefix, which makes them predictable and easy to parse. However, the verb/noun pattern is not uniform (e.g., lingo_solve is a bare verb, lingo_status is a noun, while run_commands and list_samples follow verb_noun), so it falls short of a perfect pattern.
Four tools is well-scoped for a LINGO execution server. The core solve tool, a flexible command runner, an environment status check, and a sample lister each earn their place without redundancy or bloat.
The surface covers the main workflows: solving models, executing arbitrary LINGO commands, checking installation details, and discovering samples. Minor gaps exist (e.g., no structured model validation or dedicated variable/constraint introspection), but lingo_run_commands provides a workaround for nearly any missing operation.
Related MCP Connectors
Solve production, blending, transport and scheduling problems with LP and MIP.
Optimize crew and workforce schedules, resource allocation, and routing with linear and mixed-inte…
AI-callable calculators and engineering models with real formulas. No hallucinated math.
The Excel engine for AI agents: read, check and edit Excel models over MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables solving linear programming (LP) and mixed-integer linear programming (MILP) optimization problems through natural language, with built-in simplex and branch-and-cut solvers plus infeasibility diagnostics. Includes optional OR-Tools fallback for larger problems and supports parsing optimization problems from natural language descriptions.MIT
- AlicenseNot gradedqualityDmaintenanceProvides linear programming (LP), mixed-integer programming (MIP), and quadratic programming (QP) optimization capabilities using the HiGHS solver, enabling AI assistants to solve complex optimization problems like production planning, logistics, and portfolio optimization.26 npm17MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI applications to solve optimization problems including linear programming, mixed-integer programming, and quadratic programming using the Gurobi solver installed on the local device.1-
- AlicenseCqualityDmaintenanceEnables Large Language Models to submit and solve constraint satisfaction and optimization problems using Google OR-Tools through JSON model specification.11MIT