> ## 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.

# Hardware parts catalog API: actuators, motors, Jetson

> Free JSON API for 688 hardware parts: Jetson and compute modules, motors, robot actuators and drone parts, with sourced prices, origin, NDAA status and landed cost.

[Maglev Parts](https://trymaglev.com/parts/) is an open catalog of 688 off-the-shelf hardware parts for hardware founders: compute modules, motors and motor drivers, robot actuators and transmissions, drone components and test equipment. Every part carries sources, dated prices, country of origin, NDAA and Blue UAS status, and a landed-cost estimate. No key or login is needed, and CORS is open.

Base URL: `https://trymaglev.com/parts`

## Endpoints

| Endpoint | What it returns |
| - | - |
| `/api/parts.json` | The whole catalog in one request |
| `/api/parts/{id}.json` | One part |
| `/api/categories/{category}.json` | One category: `compute-modules`, `motors`, `actuators`, `drone`, `test-equipment` |
| `/api/search?q={query}&lens={lens}&ndaa={0\|1}` | Search by part number, brand or spec words |
| `/api/route?sub={subcategory}&{key}={min}-{max}` | Rank a subcategory against your requirements. Keys are listed at `/api/find/index.json` |
| `/api/plan?peak_torque_nm=&voltage_v=` | Plan a robot joint. Also takes `speed_rpm`, `max_mass_g`, `qty` |
| `/api/landed?id={id}&qty={n}&origin={ISO2}&freight={usd}` | US landed cost estimate |
| `/api/trade.json` | Duty data used for landed cost |
| `/api/test/joint-actuator.json` | Nine bench tests for a joint actuator and three priced bench kits |
| `/p/{id}/index.md` | One part as Markdown |
| `/openapi.json` | OpenAPI description of the catalog API |

`lens` filters by where a part is made: `any`, `cn` (China including Hong Kong), `not-cn`, `us`, `usmca` (US, Canada, Mexico), `allied`.

## Examples

Find Orin NX carriers not made in China:

```bash theme={null}
curl "https://trymaglev.com/parts/api/search?q=orin%20nx&lens=not-cn"
```

Rank joint actuators with at least 60 N·m peak torque and under 1 kg:

```bash theme={null}
curl "https://trymaglev.com/parts/api/route?sub=joint-actuators&peak_torque_nm=60-&mass_g=-1000"
```

Plan a 40 N·m joint on a 48 V bus:

```bash theme={null}
curl "https://trymaglev.com/parts/api/plan?peak_torque_nm=40&voltage_v=48"
```

## Data you can trust

Every price has a source URL and the date it was seen. Fields that are not confirmed say `unknown`. Each record has a confidence: `VERIFIED` (from the maker), `REPORTED` (a credible third party) or `UNVERIFIED` (a single weak source).

## Use it from an agent

The same catalog is available as MCP tools at `https://trymaglev.com/mcp`, with no key: see [Parts tools](/docs/mcp/tools.md#parts-tools-no-key). Agent-readable summaries are at [trymaglev.com/parts/llms.txt](https://trymaglev.com/parts/llms.txt) and the full catalog as Markdown at [llms-full.txt](https://trymaglev.com/parts/llms-full.txt).

To buy listed parts, price unlisted ones or ask for custom versions, use the `build_rfq` tool or the [order pad](https://trymaglev.com/parts/pad/). Maglev returns one price for the whole request, fixed before you commit.


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