Skip to main content
Glama
Cliff MCP Server

Cliff MCP Server

Official
by cliff-hq

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

CLIFF_API_KEY

your account's key, sk_...

CLIFF_MCP_DOWNLOADS

where files are saved (default ~/Downloads/Cliff)

CLIFF_API_URL

the API (default https://api.cliff.ai)

Related MCP server: ai-cad-workbench

With SolidWorks

Add this server and a SolidWorks MCP server to the same client. A session might go:

  1. "Find an M3x12 socket head screw and put four in the motor mount": search_parts, then get_cad, which saves the STEP file and returns its path; the SolidWorks tools insert that file as a component.

  2. "What would this bracket cost to machine?": the SolidWorks tools export the part as STEP; upload_file sends that path; analyze_file and quote_made_part return Cliff's plan and each shop's price.

  3. "Price the whole assembly": export the assembly as STEP, upload_file, decompose_file (stock parts named, made parts as their own files), price_bom, then start_checkout for a page you approve.

Tools

Tool

What it does

search_parts

bought parts by name, part number, standard designation or what they must do

get_part

a part's specs, stated tolerances, documents, attribution

get_cad

the part's STEP file (millimetres), saved to disk; path in the answer

get_offers

sellers and prices for a quantity, each offer with a stable id

make_cart

chosen offers as one cart a store, with each store's own cart link

upload_file

a model or PDF print from a path on this computer

download_file

one of your files (a split assembly's part, a converted model) saved to disk

analyze_file

Cliff's measures and machining plan for a process and material

convert_file

a model as STEP, STL, OBJ or 3MF, saved to disk

decompose_file

an assembly split into its distinct parts

list_shops

shops by process and material

quote_made_part

one part, every shop's price at its own rates

quote_shop_order

several parts at one shop, as one order

price_bom, update_bom, get_bom

a design kept as one priced list; nothing is chosen for you

start_checkout, checkout_status

one page where a person reviews, approves and pays

request_removal

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…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Read-only MCP server for finding, comparing, and shortlisting engineering parts from distributor and marketplace APIs.
      6
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Lets 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
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      -