
SAGE — Solver-Augmented Grounding Engine
Connects Claude to production optimization solvers (HiGHS, OSQP, OR-Tools) via local MCP. Exposes tools to solve LP, MIP, quadratic portfolio problems, and workforce scheduling from JSON or Excel. The check_feasibility tool computes irreducible infeasible sets and ranks constraint relaxations when no solution exists, which is often more valuable than approximate answers. Returns dual values, reduced costs, and shadow prices for sensitivity analysis. Also includes read_data_file for ingesting spreadsheets and generate_template for scaffolding problem structure. Runs synchronously but supports iterative solvers that can checkpoint and resume. Useful when you need mathematically certified solutions instead of LLM approximations for resource allocation, scheduling, or portfolio construction.
- tools
- 7
- transport
- STDIO
- last updated
- Mar 6, 2026
Tools
7 toolsPublic tool metadata for what this MCP can expose to an agent.
solve_optimizationSolve LP / MIP / portfolio / scheduling from JSON
Solve LP / MIP / portfolio / scheduling from JSON
No parameter schema in public metadata yet.
read_data_fileRead an Excel or CSV file and return a preview
Read an Excel or CSV file and return a preview
No parameter schema in public metadata yet.
solve_from_fileRead + solve + write results in one step
Read + solve + write results in one step
No parameter schema in public metadata yet.
explain_solutionNarrate the most recent solve result
Narrate the most recent solve result
No parameter schema in public metadata yet.
check_feasibilityCheck feasibility; if infeasible, compute IIS
Check feasibility; if infeasible, compute IIS
No parameter schema in public metadata yet.
generate_templateCreate a blank Excel template for a problem type
Create a blank Excel template for a problem type
No parameter schema in public metadata yet.
suggest_relaxationsRank constraint relaxations for the last infeasible result
Rank constraint relaxations for the last infeasible result
No parameter schema in public metadata yet.
Sponsors
Readme
SAGE — Solver-Augmented Grounding Engine
SAGE grounds AI in mathematical truth. It is a local MCP server that gives Claude Desktop — and any MCP-compatible agent — the ability to formulate, solve, and certify mathematical optimization problems using production-grade open-source solvers.
Status: v0.1.3 — Alpha · Author: Peter Pragnakar Atreides
Why SAGE Exists
Large Language Models are probabilistic text generators. When you ask an LLM to allocate a budget, design a schedule, optimize a route, or balance a portfolio, it generates text that resembles a solution. No simplex method runs underneath. No branch-and-bound search. No constraint check. The model cannot prove optimality, certify feasibility, or — critically — declare with certainty that no feasible solution exists.
One of the most valuable outcomes in decision-making is a mathematically certified statement of infeasibility. It tells decision-makers their goals conflict, their assumptions are inconsistent, or their constraints must be renegotiated. LLMs have no native mechanism to produce this. SAGE provides it.
Details
- Repository
- github.com/pragnakar/project_sage
- Category
- AI & LLM Tools
- Package
sage-solver-mcp- Transport
- STDIO
- Registry
- MCP registry, active