> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> To use Maglev from an agent, connect the MCP server at https://trymaglev.com/mcp. Parts catalog tools need no key. Make tools (make_start, check_manufacturability, get_quotes, place_order) need a Maglev key; see https://trymaglev.com/docs/quickstart.
> Never place an order without showing the person the exact final total and getting their explicit approval.

# Maglev MCP tools reference

> All 16 Maglev MCP tools: make_start, check_manufacturability, get_quotes and place_order for custom parts, plus search, matching, landed cost and joint planning.

The Maglev MCP server at `https://trymaglev.com/mcp` exposes 16 tools. The four Make tools need a [Maglev key](/docs/authentication.md); the twelve Parts tools work without one. Your client reads each tool's full input schema with `tools/list`; this page summarizes them.

## Make tools (key required)

| Tool | What it does | Required arguments |
| - | - | - |
| `make_start` | Start here for CAD (STEP) or wire-harness (JSON) files. Returns one shell command per file that uploads it, and how each will be routed: CNC machining, sheet metal, injection molding or wire harness | `file_names` |
| `check_manufacturability` | Runs each uploaded file through its manufacturer's design-for-manufacturing check in parallel. Returns ok, blockers and warnings per file, and `ready_to_quote` | `file_ids` |
| `get_quotes` | Quotes every file from every shop that makes its process, in parallel. Returns `parts[]`, each with `offers[]` (shop, `price_type` firm or budgetary, `total_usd`, `one_time_costs`, `lead_time_days`, `ships_by`, `quote_id`) | `file_ids`, `quantity` |
| `place_order` | Without `approved_total_usd`, returns the final total and charges nothing. With the exact total a person approved and `approval_note` in their words, places the order | `quote_id` |

`check_manufacturability` and `get_quotes` also accept:

* `processes`: per-file process override, `{ file_id: process }`.
* `options`: per-file options, `{ file_id: { material, finish, tolerance_mm, wall_mm, draft_deg, speed } }`. CNC finishes are `standard`, `anodized`, `polished`, `bead_blasted`; sheet metal finishes are `as_cut`, `deburred`, `anodized`, `powder_coat`. Each offer reports `finish_applied`.

`get_quotes` takes `sort`: `price` (default) or `lead_time`.

What happens after an approved order depends on the shop: sheet metal at RMFG is charged to Maglev's card on file and becomes a production order; CNC and harness return the shop's checkout link; molding sends the request for quote to SSG MFG for a firm quote.

## Parts tools (no key)

| Tool | What it does | Required arguments |
| - | - | - |
| `search_parts` | Search the catalog (compute modules, motors and drivers, robot actuators, drone parts) by part number, brand or spec words such as "48V" or "Orin NX". Filter by origin `lens`, `ndaa_only`, `category` | none |
| `list_categories` | Categories and subcategories with part counts and the spec columns each compares on | none |
| `requirement_keys` | The requirement keys a subcategory accepts for `match_requirements`, with units and catalog ranges | `subcategory` |
| `match_requirements` | Rank every part in a subcategory against your numbers. Each result says per requirement whether it meets, is close (within 15%), misses or is unknown, and names the requirement blocking the most options | `subcategory`, `requirements` |
| `get_part` | Full record for one part: specs, dated prices with sources, maker, origin, HTS, NDAA, Blue UAS, FCC, equivalents and compatible parts | `id` |
| `compare_parts` | Side by side comparison of 2 to 10 parts: shared specs, price at a quantity, origin, NDAA | `ids` |
| `find_equivalents` | Drop-in or near equivalents from other makers, optionally by origin lens, plus parts commonly paired with it | `id` |
| `landed_cost` | US landed cost estimate: goods value, duty stack for the origin (each program with a source), merchandise processing fee and freight. An estimate, not customs advice | `id` |
| `plan_joint` | Plan a robot joint from peak torque, speed, bus voltage, mass budget and quantity. Returns complete actuators that meet the targets and joints built from motor, reducer, driver and encoder, with the math shown | `peak_torque_nm`, `voltage_v` |
| `get_test_protocol` | Nine bench tests for a robot joint actuator in run order, and three priced bench kits (starter, serious, lab) | none |
| `check_test_result` | Check a bench test result against the result format and the part's datasheet (peak and continuous torque, backlash, Kv, Kt). Nothing is stored | `result` |
| `build_rfq` | Build a request for Maglev to buy listed parts, price unlisted ones or make custom versions. Returns the request and a ready-to-send email. Nothing is sent | `items` |

Origin `lens` values: `any`, `cn` (China including Hong Kong), `not-cn`, `us`, `usmca` (US, Canada, Mexico), `allied`.

> [!NOTE]
>
> Catalog prices carry a source and the date seen. A value that is not confirmed is `unknown`; agents should report it as unknown rather than guess.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.