Moltline Optimize MCP server
Commit Nov 10, 2026Performs vehicle routing, 3-D packing, cutting stock, knapsack, and shift rostering using Google OR-Tools.
Also known as GarphenGate/moltline-mcp, optimize
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.2.0
- Last commit
- Nov 10, 2026
- License
- MIT
What is Moltline Optimize MCP?
Moltline Optimize performs vehicle routing, 3-D packing, cutting stock, knapsack, and shift rostering using Google OR-Tools.
Summary generated from the project's README
About Moltline Optimize MCP server
Moltline Optimize provides specialized mathematical optimization tools for logistics and resource management. It utilizes Google OR-Tools to handle complex computational tasks including vehicle routing, 3-D packing, knapsack problems, cutting stock, and shift rostering. These tools are designed for developers and businesses needing to solve spatial and scheduling constraints through an AI client.
Users can access these capabilities via a stdio bridge or through direct Streamable HTTP connections. The free tier requires no registration or credentials, allowing for immediate tool calls. For access to premium tools, users must provide a Moltline license via the MOLTLINE_LICENSE environment variable, which the bridge securely transmits as a request header. The server is part of a larger fleet of 22 hosted MCP servers provided by Moltline Studio.
What you can do with it
- 1Optimize vehicle delivery routesAn AI agent can use the routing tools to plan the most efficient paths for a fleet of vehicles.
- 2Calculate efficient cargo packingDevelopers can request 3-D packing solutions to determine how items should be arranged in a container.
- 3Manage employee work schedulesThe server can automate the creation of staff rosters based on specific constraints.
- 4Solve material cutting problemsUsers can optimize how materials are cut to minimize waste using 1-D or 2-D cutting algorithms.
Written from the project's README. Every use case is checked against a quote from it.
How to install Moltline Optimize MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Moltline Optimize MCP in Claude Code
$ claude mcp add --transport http optimize https://mcp.moltlinestudio.com/optimizeInstall Moltline Optimize MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"optimize": {
"url": "https://mcp.moltlinestudio.com/optimize"
}
}
}Install Moltline Optimize MCP in VS Code
.vscode/mcp.json
{
"servers": {
"optimize": {
"type": "http",
"url": "https://mcp.moltlinestudio.com/optimize"
}
}
}Install Moltline Optimize MCP in VS Code CLI
$ code --add-mcp '{"name":"optimize","type":"http","url":"https://mcp.moltlinestudio.com/optimize"}'Install Moltline Optimize MCP in Codex
$ codex mcp add optimize --url https://mcp.moltlinestudio.com/optimizeInstall Moltline Optimize MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.optimize] url = "https://mcp.moltlinestudio.com/optimize"
Install Moltline Optimize MCP in Gemini CLI
$ gemini mcp add -s user --transport http optimize https://mcp.moltlinestudio.com/optimizeInstall Moltline Optimize MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"optimize": {
"url": "https://mcp.moltlinestudio.com/optimize",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablegarphengate/moltline-mcp is public and reachablegithub.com/garphengate/moltline-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/garphengate/moltline-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 229 msPass
README
View on GitHubmoltline-mcp
A thin, dependency-free stdio bridge to Moltline Studio's fleet of 22 hosted MCP servers.
Most modern MCP clients can connect to the fleet directly over Streamable HTTP, no install needed (see Direct connection below). This bridge exists for clients that only speak the stdio transport: it proxies newline-delimited JSON-RPC between your client and the hosted server, verbatim, with no telemetry and no dependencies beyond the Python 3.9+ standard library.
- 160 tools across 22 servers; 110 are free.
- Free tier: no registration, no account, no credentials. Connect and call tools immediately.
- Premium tools are unlocked with a Moltline license. Set
MOLTLINE_LICENSEin your MCP client's environment; the bridge sends it as theX-Moltline-Licenseheader and never writes it to argv, URLs or logs. See auth.md. - Independently checked by MCPize on the direct endpoints (scans of 5–6 September 2026: 6 A+, 15 A, 1 B+; scores 89–98). All 22 servers score 100 on clarity, 100 on reliability and 100 on trust, 95 on protocol and 87 on safety; the one finding raised on every server is that the free tier accepts anonymous access (which is the point of it), and the spread between servers sits in MCPize's "Market" dimension (a crowded category). Each server's MCPize listing links its own public result.
Find it on: MCPize · Glama · Clawmart · MCP Registry
The fleet
| Server | Tools | What it does |
|---|---|---|
catalog |
10 | Search 138 agent skills and personas by plain-language job; preview any product. |
codereview |
7 | Risk-scan a diff, flag AI-generated-code tells, find secrets, report complexity. |
govern |
8 | Audit an MCP config or SKILL.md for over-broad scope and prompt-injection risk. |
timeops |
5 | Business days, meeting overlap, recurrence expansion, deadline and SLA math. |
data |
7 | Paste-your-data analytics: CSV profiling, A/B tests, correlation, growth, cohorts. |
humanizer |
5 | Find AI-isms with evidence, fingerprint a writing voice, measure burstiness. |
business |
8 | 30 finance, bookkeeping, legal-ops and SMB operations persona-skill products. |
creator |
8 | 20 blogging, brand-voice, copywriting, video and social persona-skill products. |
educator |
7 | 8 curriculum, classroom, accommodations and exam-prep persona-skill products. |
outbound |
8 | 7 outreach, sequencing, deliverability, call-coaching and CRM-hygiene products. |
personal |
9 | 20 inbox, calendar, travel, meals and family-logistics persona-skill products. |
research |
8 | 7 research navigation, thesis, note-taking and citation persona-skill products. |
skillmd-lint |
6 | Lint a SKILL.md for frontmatter, structure, secrets and size. All tools free. |
merchant |
6 | Commerce arithmetic: processor fees, charge-to-net, invoice totals, proration. |
shipping |
6 | Dimensional weight, parcel fit, landed cost, freight class, rate cards. |
shopify |
6 | Check a product CSV, URL handles, variant matrices and metafield keys. |
dropship |
6 | Dropshipping unit economics: margin, lead time, SKU mapping, price ladders. |
recall |
6 | A portable knowledge-graph memory you pass in and get back. No database. |
vision |
6 | Image header probing, bbox conversion, resize plans, color and detection math. |
regclock |
9 | Incident-reporting deadlines from the legal text (EU CRA, NIS2, DORA, GDPR, UK GDPR, HIPAA, SEC 8-K), cited. |
taxlots |
8 | Crypto cost basis: parse exchange CSVs, lint, match transfers, FIFO/LIFO/HIFO lots, Form 8949 rows, 1099-DA diff. |
optimize |
11 | OR-Tools routing, 3-D packing, 1-D/2-D cutting, knapsack and shift rostering with stated limits. |
Machine-readable discovery: api-catalog · per-server card at https://mcp.moltlinestudio.com/<server>/.well-known/mcp/server-card.json · fleet health.
Direct connection (preferred)
If your MCP client supports Streamable HTTP (Claude Desktop, Claude Code, Cursor, and most current clients do), point it straight at the hosted endpoint (nothing to install):
{
"mcpServers": {
"moltline-timeops": {
"type": "http",
"url": "https://mcp.moltlinestudio.com/timeops"
}
}
}
Swap timeops for any slug in the table above.
The stdio bridge (for stdio-only clients)
Install
Run directly (recommended): the bridge is a single stdlib-only file, so a clone is all you need:
git clone https://github.com/GarphenGate/moltline-mcp.git
python3 moltline-mcp/moltline_mcp.py timeops # any of the 22 slugs; default: catalog
Docker: see Docker below if you prefer a container.
A PyPI package is planned; until then, use the methods above.
Client configuration
Point your MCP client at the script with an absolute path:
{
"mcpServers": {
"moltline-timeops": {
"command": "python3",
"args": ["/absolute/path/to/moltline-mcp/moltline_mcp.py", "timeops"]
}
}
}
Or run it through Docker (after docker build -t moltline-mcp .):
{
"mcpServers": {
"moltline-timeops": {
"command": "docker",
"args": ["run", "-i", "--rm", "moltline-mcp", "timeops"]
}
}
}
CLI
python3 moltline_mcp.py [server] [--timeout SECONDS] [--list] [--version]
server: one of the 22 slugs (defaultcatalog); anything else fails fast with the valid list.--timeout: per-request timeout in seconds (default 300, or envMOLTLINE_TIMEOUT).--list: print the server slugs and exit.- Env
MOLTLINE_BASE_URL: override the fleet base URL (for testing). - Env
MOLTLINE_LICENSE: your Moltline license, sent as theX-Moltline-Licenseheader to unlock premium tools. Omit it and the bridge runs free-tier only. - Env
MOLTLINE_DEBUG=1: diagnostic logging on stderr (stdout stays protocol-clean). The license is never logged; debug output reports only whether one is configured.
Docker
The bridge also runs containerized (stdio in, network egress to the fleet required):
docker build -t moltline-mcp .
docker run -i --rm moltline-mcp timeops # any of the 22 slugs; default: catalog
See Client configuration for the matching mcpServers entry.
How it works
One process per server connection. Each JSON-RPC message read from stdin is POSTed to https://mcp.moltlinestudio.com/<server>; JSON and SSE-framed responses are relayed back to stdout as newline-delimited JSON. The bridge tracks the server-assigned Mcp-Session-Id and echoes the negotiated MCP-Protocol-Version, per the Streamable HTTP transport spec. It never inspects, stores, or reports your traffic.
Tests
The bridge ships with an offline test suite - no network, no dependencies:
python -m unittest -v
Twenty-two tests cover the parts that actually break in a transport bridge:
newline-delimited framing, SSE event splitting (multiple events, multi-line
data: payloads, a trailing event with no blank line, comments and named
events), session-id capture and reuse, protocol-version negotiation on
initialize only, and error relay - a JSON-RPC error document is passed
through verbatim, anything else becomes a well-formed -32603. CI runs them
on Python 3.9, 3.12 and 3.13, plus a Docker build and container smoke test.
Access and licensing
- Free tier: anonymous. No registration or credentials; all free tools work immediately.
- Premium: unlocked with a Moltline license purchased (human-in-the-loop) at moltlinestudio.com. Set
MOLTLINE_LICENSEin the environment and the bridge forwards it as theX-Moltline-Licenserequest header. It is deliberately not a command-line flag: argv is world-readable throughps. It is never placed in a URL and never logged. Details: auth.md.
Links
- Website: https://moltlinestudio.com
- Agent access guide: https://moltlinestudio.com/auth.md
- API catalog: https://moltlinestudio.com/.well-known/api-catalog
- Agent protocol reference (x402, AP2, ACP, UCP, MPP, A2A): https://moltlinestudio.com/protocols.html
- Community: https://community.moltlinestudio.com
- Issues and security reports: see SECURITY.md
License
MIT © 2026 Moltline Studio
Moltline Optimize MCP questions
How do I add Moltline Optimize MCP to Claude Code?
Run claude mcp add --transport http optimize https://mcp.moltlinestudio.com/optimize in your terminal. Add --scope user to make it available in every project.
How do I add Moltline Optimize MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What kind of optimization tasks can this server perform?
It handles vehicle routing, 3-D packing, 1-D/2-D cutting stock, knapsack problems, and shift rostering with defined limits.
How do I unlock premium tools?
Premium tools are unlocked by setting a MOLTLINE_LICENSE in your MCP client's environment.