MCP Solver MCP Server

Model Context Protocol (MCP) server for constraint optimization and solving"

Local serverstdioPython

What is the MCP Solver MCP server?

Model Context Protocol (MCP) server for constraint optimization and solving". Exposed over MCP by the mcp solver mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

An MCP server for constraint solving (SAT, MaxSAT, SMT, CP, ASP, DP). It turns the connected LLM host into a solver-writing agent: the host gets a Python kernel preloaded with a real solver library, modeling instructions for the chosen backend, and a submission gate. The host encodes the problem, runs and verifies it against the real solver, and submits the final program — the outcome is the solution plus the verified solver program that produced it.

Its toolset

Everything the assistant can do here goes through one of these:

  • Resources — ** mcp-solver://guide (backend selection and workflow) and
  • Backend — Domain
  • pysat — Boolean satisfiability (SAT)
  • maxsat — Weighted optimization
  • cpmpy — Constraint programming (CP)
  • clingo — Answer Set Programming (ASP)
  • didp — Dynamic programming (DIDP)
  • Execution — Inside the MCP server
  • Verification — Manual, by the host LLM
  • Artifact — Transient model state
  • Backends — MiniZinc, PySAT, MaxSAT, Z3, ASP

Adding it to your client

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Configuration

You will need one environment variable: OPENROUTER_API_KEY. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Python 3.13 - uv (a hard runtime requirement: solver libraries are supplied at solve time via uv run --with) - An OpenRouter API key — for the CLI and benchmark harness only; the MCP server itself runs without one

When to reach for it

Plenty of AI and media services servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. MCP Solver's toolset — Resources, Backend, pysat and 8 more — is a fair guide to whether it matches your workflow. It is maintained by szeider; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 11 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch MCP Solver.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the mcp solver mcp server does with a few real requests.

Available tools

ToolWhat it does
Resources** mcp-solver://guide (backend selection and workflow) and
BackendDomain
pysatBoolean satisfiability (SAT)
maxsatWeighted optimization
cpmpyConstraint programming (CP)
clingoAnswer Set Programming (ASP)
didpDynamic programming (DIDP)
ExecutionInside the MCP server
VerificationManual, by the host LLM
ArtifactTransient model state
BackendsMiniZinc, PySAT, MaxSAT, Z3, ASP

How to install the MCP Solver MCP server

{
  "mcpServers": {
    "mcp-solver": {
      "command": "uvx",
      "args": ["--from", "mcp-solver[agent]", "mcp-solver-serve"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Python 3.13 - uv (a hard runtime requirement: solver libraries are supplied at solve time via uv run --with) - An OpenRouter API key — for the CLI and benchmark harness only; the MCP server itself runs without one
VariableDescriptionRequired
OPENROUTER_API_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use MCP Solver to Resources.
  • Use MCP Solver to Backend.
  • Use MCP Solver to pysat.

Frequently asked questions

Python 3.11+, `uv` package manager, and solver-specific dependencies (MiniZinc, PySAT, Z3, Clingo). Supports macOS, Windows, and Linux.