Cliff MCP Server
OfficialWorks alongside a FreeCAD MCP server so agents can search for bought parts and save STEP files for insertion into FreeCAD, upload FreeCAD-exported models for analysis and machining quotes, decompose assemblies, price BOMs, and start checkout.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Cliff MCP server
Hardware parts, CAD files, machining quotes and orders as MCP tools, for any MCP client: Claude Desktop, Claude Code, Cursor, or your own agent. Run it next to your CAD tool's MCP server (SolidWorks, Fusion, FreeCAD, Onshape) and your agent can:
find a bought part (screws, bearings, servos, connectors, boards) and save its STEP file to disk, ready to open or insert into an assembly;
upload a model you exported from your CAD tool by its path, and get Cliff's measures and machining plan for it;
split an assembly into its parts, name the stock ones, and save each made part as its own STEP file;
quote made parts at real shops at their own rates, keep a whole design as one priced BOM, and turn it into one checkout page that a person reviews and pays. Nothing is bought until they do.
Every tool is one call to Cliff's API (https://api.cliff.ai/v1). The server keeps no state of its own.
Set up
Node 20 or newer.
{
"mcpServers": {
"cliff": {
"command": "npx",
"args": ["-y", "@cliff-hq/mcp"],
"env": { "CLIFF_API_KEY": "sk_..." }
}
}
}Claude Code: claude mcp add cliff --env CLIFF_API_KEY=sk_... -- npx -y @cliff-hq/mcp
Searching parts, reading them, their CAD and their offers need no key. Uploading files, quotes, BOMs and checkouts need an API key from your Cliff account.
Variable | Meaning |
| your account's key, |
| where files are saved (default |
| the API (default |
Related MCP server: ai-cad-workbench
With SolidWorks
Add this server and a SolidWorks MCP server to the same client. A session might go:
"Find an M3x12 socket head screw and put four in the motor mount":
search_parts, thenget_cad, which saves the STEP file and returns itspath; the SolidWorks tools insert that file as a component."What would this bracket cost to machine?": the SolidWorks tools export the part as STEP;
upload_filesends that path;analyze_fileandquote_made_partreturn Cliff's plan and each shop's price."Price the whole assembly": export the assembly as STEP,
upload_file,decompose_file(stock parts named, made parts as their own files),price_bom, thenstart_checkoutfor a page you approve.
Tools
Tool | What it does |
| bought parts by name, part number, standard designation or what they must do |
| a part's specs, stated tolerances, documents, attribution |
| the part's STEP file (millimetres), saved to disk; |
| sellers and prices for a quantity, each offer with a stable id |
| chosen offers as one cart a store, with each store's own cart link |
| a model or PDF print from a path on this computer |
| one of your files (a split assembly's part, a converted model) saved to disk |
| Cliff's measures and machining plan for a process and material |
| a model as STEP, STL, OBJ or 3MF, saved to disk |
| an assembly split into its distinct parts |
| shops by process and material |
| one part, every shop's price at its own rates |
| several parts at one shop, as one order |
| a design kept as one priced list; nothing is chosen for you |
| one page where a person reviews, approves and pays |
| a rights holder's takedown request |
Geometry measured from a STEP file is nominal, never a tolerance. Tolerances are given only where a vendor or a standard states them. Vendor files carry their attribution and a link back to the vendor.
Files and privacy
The server reads a file from your computer only when upload_file is called with its path, and only models, PDF
prints and images (STEP, IGES, STL, OBJ, 3MF, native CAD formats, PDF, PNG, JPEG), up to 256 MB. It writes only
into the downloads folder (or the save_to folder a tool call names), never over an existing file.
License
Apache License 2.0 (LICENSE, NOTICE). The license covers this server's code. Using Cliff's API, and the parts
data, CAD files, quotes and orders it serves, is governed by Cliff's terms; vendor
CAD files carry their own attribution and licence, returned with each file.
Contract
The tools are the same ones Cliff's hosted MCP server serves at https://api.cliff.ai/mcp, read from the same
manifest (contract/mcp-tools.json), and every call is described in contract/openapi.json. The package's tests hold
it to both, offline and against a running API (npm test; the live part runs when CLIFF_TEST_API_URL,
CLIFF_TEST_API_KEY and CLIFF_TEST_STEP are set).
This repository is published from Cliff's monorepo, where the server and the contract are developed together; issues and pull requests are welcome here.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search multi-merchant supply, checkout, and track orders via MCP.
Governed data discovery, exact queries, decisions, simulations, and runtime utilities over MCP.
MCP commerce surface for compute credits, API keys, GPU instances, and cloud storage.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Related MCP Servers
- AlicenseBqualityCmaintenanceRead-only MCP server for finding, comparing, and shortlisting engineering parts from distributor and marketplace APIs.6MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for AI-driven CAD operations, enabling parametric modeling, build, inspection, measurement, rendering, and diff comparison with STEP, DXF, and GLB export.MIT
- AlicenseNot gradedqualityCmaintenanceLets MCP clients search versioned design notes, plan and generate real CadQuery/OpenCascade parts from a measured brief, inspect geometry reports and exported artifacts, and prepare local slicer jobs through typed tools, resources and a design prompt. It covers electronics enclosures, L-brackets and flanged adapters with STEP/STL/3MF/GLB exports, but provides no printer control or physical print capability.MIT
- FlicenseNot gradedqualityBmaintenanceEnables users to create and manage workspace-scoped CAD contracts, build and validate STEP-backed geometry, generate technical drawings and proof renders, audit models, and sample motion through bounded MCP tools.-