Agent Tool

Parametric Part Designer

Name: Parametric Part Designer
Brand: Apoth3osis
SKU: 6ae3e6cf6b8e2f458be7d958
Price: 0.05 USD
Availability: InStock

Available ActionsEach successful request consumes credits as outlined below.

list_templatesbuild_part^5crimport_part^5crrevise_part^5crmeasure_part^2crrender_part^2crexport_part^3crget_partlist_partsget_taskcancel_task

Details

Design precise mechanical parts and assemblies from dimensions and editable scripts, all in one place. Start from built-in templates such as brackets, enclosures, flanges and spacers, write a parametric script, or import an existing STEP, BREP or DXF file. Every build comes back with validated measurements, a hole table, pass or fail results for the dimensions you expect, and preview images, so you can confirm the part is right before using it. Change any dimension to create a new revision while earlier versions stay available. Check clearance and interference between parts, mass and center of gravity, distances and cross sections, then export exact STEP and BREP for CAD, STL and 3MF for 3D printing, GLB and glTF for viewers, and DXF or SVG drawings.

Workflows Using This Tool

Workflow

Saves ~4 hr

Engineering Drawings to Verified STEP Models

Converts a package of 2D engineering drawings into dimensionally verified STEP models with a full audit trail. For each sheet the agent inventories the title block, builds a provenance-tracked dimension table (every value labeled, measured, computed or flagged as an assumption), hand-computes acceptance values (bounding box, volume, cross-section areas) from the drawing arithmetic BEFORE modeling, then builds a parametric CadQuery model in the Parametric Part Designer with live dimension checks, reconciles every check, verifies the solid independently with face distances, mass properties and sections, renders line drawings with hidden edges to lay over the source sheet, and writes a per-part tolerance record with acceptance bands under the sheet's general tolerance standard (e.g. ISO 2768-m). Finishes with a package report and a human review gate for the open engineering questions. Deliverables per part: exact B-rep STEP, watertight STL, screenshots, the parametric script and the verification evidence.

Use Cases

Design a mounting bracket to exact dimensions, Create a 3D printable enclosure with a lid, Check that two parts do not interfere, Convert a DXF profile into a solid part, Export STEP and STL files for manufacturing, Iterate a part by changing parameters, Measure mass and center of gravity of a design

Dynamic MCP Setup

Connect once through AgentPMT Dynamic MCP, then use approved tools from the same agent connection.

30 Second Setup

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections.

npm install -g @agentpmt/mcp-routeragentpmt-setup

Hosted Streamable HTTPS

MCP endpoint for browser-based apps like ChatGPT, Claude, Grok, or any time you want a streamable connection with no local install.

https://api.agentpmt.com/mcp

Config Example

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Full connection guide

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

Need client videos, organization controls, audit details, and the full feature overview?

More About Dynamic MCP

Actions(11)

list_templates1 param

List the built-in part templates with every parameter, its default, unit and allowed range. Free.

template_idstring

Return only this template, including its full script.

Values:

mounting_platel_bracketu_bracketenclosureenclosure_lidspacerstandoffflangeshaft_collarpipe_clampknobcable_clip

build_part^5cr8 params

Build a new part from CadQuery Python or a built-in template. Returns validated measurements, a hole table, check results, preview images and the requested files in one response. Script errors return the failing line and a specific fix.

scriptstring

CadQuery Python; cq is preloaded. Publish with show_object(shape, name='body') or assign the final shape to result. Top-level number, string and boolean assignments become parameters. Several show_object calls or a cq.Assembly make a multi-body part. Give script or template_id.

template_idstring

Built-in template to build. Give script or template_id.

Values:

mounting_platel_bracketu_bracketenclosureenclosure_lidspacerstandoffflangeshaft_collarpipe_clampknobcable_clip

parametersarray

Parameter overrides by name. Names must match top-level assignments in the script or template; unknown names are rejected with the valid names. Set exactly one of value, text or flag.

Array of: object

unitsstring

Units for all lengths in the script, parameters, checks and results. Default mm.

Values:

mmcmmin

checksarray

Expected results to verify after building; each returns passed true or false with the measured value. hole_diameter passes when at least one hole has that diameter.

Array of: object

export_formatsarray

Files to produce. Default step and stl.

Array of: string

viewsarray

Preview images to return. Default iso, top and front.

Array of: string

namestring

Readable part name used in file names.

import_part^5cr6 params(1 required)

Import a STEP, BREP or DXF file as a new part to measure, render, export or modify with a script. STEP assemblies keep body names and colors; DXF files become flat profiles.

file_idrequiredstring

File Manager ID of a .step, .stp, .brep or .dxf file.

unitsstring

Units of the file. STEP declares its own; needed for BREP and DXF. Default mm.

Values:

mmcmmin

checksarray

Expected results to verify after building; each returns passed true or false with the measured value. hole_diameter passes when at least one hole has that diameter.

Array of: object

export_formatsarray

Files to produce. Default step and stl.

Array of: string

viewsarray

Preview images to return. Default iso, top and front.

Array of: string

namestring

Readable part name used in file names.

revise_part^5cr7 params(1 required)

Create a new revision by changing parameters, replacing the script, or both. Earlier revisions stay unchanged. Returns measurements, checks, previews and the changes from the base revision.

part_idrequiredstring

Part identifier returned by build_part or import_part.

base_revisioninteger

Revision to start from. Default: the latest.

Range: 1 - ...

parametersarray

Parameter overrides by name. Names must match top-level assignments in the script or template; unknown names are rejected with the valid names. Set exactly one of value, text or flag.

Array of: object

scriptstring

Full replacement script. For imported parts the variable imported holds the imported shape (flat DXF profiles are ready to extrude, e.g. result = imported.extrude(5)). Omit to keep the base script.

checksarray

Expected results to verify after building; each returns passed true or false with the measured value. hole_diameter passes when at least one hole has that diameter.

Array of: object

export_formatsarray

Files to produce. Default step and stl.

Array of: string

viewsarray

Preview images to return. Default iso, top and front.

Array of: string

measure_part^2cr3 params(1 required)

Measure a part precisely: size and mass properties, hole table, clearance or interference between bodies, distances between features, and cross sections.

part_idrequiredstring

Part identifier returned by build_part or import_part.

revisioninteger

Revision number. Default: the latest revision.

Range: 1 - ...

measurementsarray

Measurements to take. Default overview.

Array of: object

render_part^2cr11 params(1 required)

Render PNG images of a part: shaded views, line drawings with hidden edges, a section view or a custom camera direction.

part_idrequiredstring

Part identifier returned by build_part or import_part.

revisioninteger

Revision number. Default: the latest revision.

Range: 1 - ...

viewsarray

Views to render. Default iso.

Array of: string

directionarray

Custom view direction from the part toward the camera, e.g. [1, -1, 1].

Array of: number

stylestring

shaded or lines (engineering line drawing). Default shaded.

Values:

shadedlines

show_hidden_edgesboolean

Draw hidden edges dashed in the lines style. Default false.

section_planestring

Cut the part along this axis before rendering.

Values:

XYZ

section_offsetnumber

Section position along section_plane in part units. Default: the middle.

highlight_bodiesarray

Body names drawn in an accent color.

Array of: string

width_pxinteger

Image width. Default 1024.

Range: 256 - 2048

height_pxinteger

Image height. Default 768.

Range: 256 - 2048

export_part^3cr9 params(2 required)

Export a part revision with explicit mesh accuracy. Mesh files report triangle count and watertightness. dxf is the cross section at section_offset along the projection axis; svg is a line drawing of the projection view.

part_idrequiredstring

Part identifier returned by build_part or import_part.

formatsrequiredarray

Formats to export.

Array of: string

revisioninteger

Revision number. Default: the latest revision.

Range: 1 - ...

bodiesarray

Body names to include. Default: all bodies.

Array of: string

linear_tolerancenumber

Maximum mesh deviation from the true surface in part units. Default 1 percent of the part size, at most 0.1 mm.

Range: 0.0001 - ...

angular_tolerance_degnumber

Maximum angle between adjacent mesh facets in degrees. Default 5.

Range: 0.5 - 45

projectionstring

View for svg and section axis for dxf. Default top.

Values:

isotopbottomfrontbackleftright

section_offsetnumber

dxf section position along the projection axis in part units. Default: the middle.

filenamestring

Base file name without folder or extension.

get_part2 params(1 required)

Get a part with its revision history, script, parameter values, latest measurements and files. Free.

part_idrequiredstring

Part identifier returned by build_part or import_part.

revisioninteger

Revision number. Default: the latest revision.

Range: 1 - ...

list_parts2 params

List your parts, newest first. Free.

cursorstring

next_cursor from the previous response.

limitinteger

Maximum results. Default 20.

Range: 1 - 100

get_task2 params(1 required)

Check work that returned status processing. Completed tasks return the original action result in outputs[0]. Free.

task_idrequiredstring

task_id from a processing response.

wait_secondsinteger

Seconds to wait for completion (0-55); use 55 when polling. Default 0.

Range: 0 - 55

cancel_task1 param(1 required)

Cancel work that is still processing. Free.

task_idrequiredstring

task_id from a processing response.

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "6ae3e6cf6b8e2f458be7d958",
    "parameters": {
      "action": "list_templates"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "6ae3e6cf6b8e2f458be7d958",
    "parameters": {
        "action": "list_templates"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6ae3e6cf6b8e2f458be7d958",
  parameters: {
    "action": "list_templates"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "6ae3e6cf6b8e2f458be7d958",
  parameters: {
    "action": "list_templates"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Parametric Part Designer

Build exact CAD parts from CadQuery Python or built-in templates; every build returns validated measurements, a hole table, your dimension checks, preview images and files.

Workflow

build_part with a script or template_id, plus checks for the dimensions you expect.
Read checks.all_passed and look at previews. If something is off, revise_part by parameter name.
measure_part, render_part and export_part work on any revision.

Any action that runs the geometry engine returns its result directly when it finishes within about 20 seconds. Longer work returns status: "processing" with a task_id; call get_task with wait_seconds: 55 until completed (the result is in outputs[0]) or failed. Tasks are saved before work starts, so they survive server restarts (an interrupted job restarts automatically from the beginning) and wait in a queue when every engine is busy; you never need to resubmit a processing task.

Writing scripts

cq (CadQuery) is preloaded. Publish shapes with show_object(shape, name="body"); several calls make a multi-body part, and a cq.Assembly keeps its child names and constraints. If you never call show_object, a variable named result, part, assembly or model is published.
Top-level assignments of a number, string or boolean (thickness = 5.0) become parameters you can change later with revise_part.
All lengths are in the part units (default mm); angles are degrees.
Booleans: if a union or cut reports CAD_INVALID_GEOMETRY, add clean=False, e.g. a.union(b, clean=False).
Select by geometry, not index; face and edge order changes between revisions.

Selectors: >Z / <X farthest along an axis, |Z parallel to Z, #Z perpendicular, +Z / -Z normal direction, %PLANE %CYLINDER %LINE %CIRCLE by type, >Z[1] second farthest, combine with and, or, not. Examples: faces(">Z"), edges("|Z"), edges(">Z and |X").

Actions

`get_instructions`

Returns this documentation.

`list_templates`

Optional: template_id (returns its full script). Templates: mounting_plate, l_bracket, u_bracket, enclosure, enclosure_lid, spacer, standoff, flange, shaft_collar, pipe_clamp, knob, cable_clip. Defaults and ranges are in mm and convert to other units.

{"action":"list_templates"}

`build_part`

Required: script (string) or template_id. Optional: parameters (array of {name, value|text|flag}), units (mm, cm, m, in; default mm), checks (array of {quantity, expected, tolerance, body}), export_formats (default step and stl), views (default iso, top, front), name.

Check quantities: size_x, size_y, size_z, volume, surface_area, solid_count, hole_count, hole_diameter (passes if any hole matches), center_of_mass_x/y/z, is_valid (1 or 0). Default tolerance 0.01 part units, 0 for counts.

{"action":"build_part","template_id":"mounting_plate","parameters":[{"name":"thickness","value":8}],"checks":[{"quantity":"size_z","expected":8},{"quantity":"hole_count","expected":4}]}

{"action":"build_part","script":"width = 40.0\nplate = cq.Workplane('XY').box(width, 30, 5).faces('>Z').workplane().hole(6)\nshow_object(plate, name='plate')","checks":[{"quantity":"hole_diameter","expected":6}],"export_formats":["step","stl","3mf"]}

Multi-body example: {"action":"build_part","script":"base = cq.Workplane('XY').box(50, 30, 20).faces('>Z').shell(-2)\nlid = cq.Workplane('XY').box(50, 30, 2).translate((0, 0, 11))\nshow_object(base, name='base')\nshow_object(lid, name='lid')"}

`import_part`

Required: file_id (.step, .stp, .brep or .dxf). Optional: units (needed for BREP and DXF; STEP declares its own), checks, export_formats, views, name. STEP assemblies keep body names and colors; DXF becomes a flat profile.

{"action":"import_part","file_id":"FILE_ID","checks":[{"quantity":"is_valid","expected":1}]}

`revise_part`

Required: part_id, plus parameters, script, or both. Optional: base_revision (default latest), checks, export_formats, views. Parameter changes merge with the base revision's values (other values, in any units, are kept). Every revision gets its own number, even when several run at once. For imported parts send a script that uses the variable imported (flat DXF profiles extrude directly). The response includes changes from the base revision.

{"action":"revise_part","part_id":"PART_ID","parameters":[{"name":"thickness","value":6}],"checks":[{"quantity":"size_z","expected":6}]}

{"action":"revise_part","part_id":"PART_ID","script":"result = imported.extrude(5)"}

`measure_part`

Required: part_id. Optional: revision, measurements (default overview). Kinds: overview, mass_properties (density g/cm3), holes, clearance (body_a and body_b, or all pairs), distance (selector_a, selector_b, target faces/edges/vertices/solids), section (plane X/Y/Z, offset; returns area, perimeter and an outline SVG).

{"action":"measure_part","part_id":"PART_ID","measurements":[{"kind":"clearance","body_a":"base","body_b":"lid"},{"kind":"mass_properties","density":1.24}]}

{"action":"measure_part","part_id":"PART_ID","measurements":[{"kind":"distance","selector_a":">Z","selector_b":"<Z"}]}

`render_part`

Required: part_id. Optional: revision, views (default iso), direction ([x, y, z] toward the camera), style (shaded or lines), show_hidden_edges, section_plane and section_offset, highlight_bodies, width_px, height_px.

{"action":"render_part","part_id":"PART_ID","views":["front","right"],"style":"lines","show_hidden_edges":true}

`export_part`

Required: part_id, formats (step, stl, 3mf, glb, gltf, brep, amf, vrml, vtp, dxf, svg). Optional: revision, bodies, linear_tolerance (part units), angular_tolerance_deg, projection (svg view, dxf section axis), section_offset, filename.

Units: step declares the part units; 3mf and amf are millimeters; glb and gltf are meters; stl, brep, vrml, vtp, dxf and svg are in the part units. Mesh files report triangle_count and watertight.

{"action":"export_part","part_id":"PART_ID","formats":["step","stl"],"linear_tolerance":0.02}

`get_part`

Required: part_id. Optional: revision. Returns the revision list and the chosen revision's script, parameters, measurements and files.

{"action":"get_part","part_id":"PART_ID"}

`list_parts`

Optional: cursor (from next_cursor), limit (1-100, default 20).

{"action":"list_parts","limit":20}

`get_task`

Required: task_id. Optional: wait_seconds (0-55; returns as soon as the task finishes). stage shows progress: queued, loading, the running operation, saving. restarts appears if the job was interrupted and restarted.

{"action":"get_task","task_id":"TASK_ID","wait_seconds":55}

`cancel_task`

Required: task_id. Stops a queued or running job; returns cancelled: true once it has stopped. A job that is already saving its results completes instead (cancelled: false). A cancelled job creates nothing.

{"action":"cancel_task","task_id":"TASK_ID"}

Response

Build, import and revise return part_id, revision, units, overview (size, min, max, volume, per-body details, all_valid), holes (diameter, depth, through, kind, axis, start, end, stack), checks (all_passed and each result with measured and difference), parameters (name, kind, default, value), previews and files (each with file_id and signed_url), and warnings. Generated files are kept for 7 days.

Errors

Script and geometry errors include a fix, and error_details with the failing line and source_line (or valid_parameters): CAD_SCRIPT_ERROR, CAD_NO_OUTPUT, CAD_FEATURE_FAILED (fillet, shell, boolean and similar), CAD_SELECTOR_INVALID, CAD_SELECTOR_EMPTY, CAD_UNKNOWN_PARAMETER (lists valid names), CAD_INVALID_PARAMETER, CAD_INVALID_GEOMETRY, CAD_IMPORT_FAILED, CAD_BODY_NOT_FOUND, CAD_MEASUREMENT_FAILED, CAD_EMPTY_RESULT. Tool errors: PART_DESIGNER_PART_NOT_FOUND, PART_DESIGNER_REVISION_NOT_FOUND, PART_DESIGNER_INVALID_PARAMETER, PART_DESIGNER_UNSUPPORTED_FILE, PART_DESIGNER_SCRIPT_REQUIRED, PART_DESIGNER_PART_EXPIRED. Limits: GEOMETRY_TIMEOUT, GEOMETRY_MEMORY_LIMIT, GEOMETRY_ENGINE_CRASH, GEOMETRY_INPUT_TOO_LARGE, GEOMETRY_INPUT_EXPIRED, GEOMETRY_WORKER_BUSY, GEOMETRY_WORKER_UNAVAILABLE. Tasks: GEOMETRY_TASK_NOT_FOUND, GEOMETRY_TASK_INTERRUPTED (restarted three times without finishing; run the action again).

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Use the AgentPMT-Tool-Search-and-Execution tool. First call action 'get_instructions' so you know how to use the tool search interface. Then call action 'get_schema' with tool_id 6ae3e6cf6b8e2f458be7d958 ("Parametric Part Designer"). After reading the schema and any returned instructions, tell me what this tool can do, we are going to be using it

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Can I change a part after it is built?

Yes. revise_part changes any parameter by name or replaces the script and creates a new numbered revision that reports what changed. Earlier revisions stay available for measuring, rendering and exporting.

Can it check that parts fit together?

Yes. Publish several bodies or a cq.Assembly, then use measure_part to get clearance, interference volume and the minimum gap between bodies, distances between selected faces or edges, cross sections, and mass and center of gravity from a density.

Do I need a CAD program or an Onshape account?

No. Parts are built with CadQuery on the OpenCascade kernel inside the tool, and every file is saved to your File Manager. The STEP and BREP exports are exact solids that open in any CAD program.

How do I know a generated part has the right dimensions?

Every build, import and revision returns the measured size, volume, center of mass and validity of each body, a hole table, preview images, and pass or fail results for the checks you request, such as size_x, hole_count or hole_diameter. If checks.all_passed is false, change the failing parameter with revise_part.

How long are files kept, and what does it cost?

Generated files stay in your File Manager for 7 days. build_part, import_part and revise_part cost 5 credits, export_part costs 3, and measure_part and render_part cost 2. list_templates, get_part, list_parts, get_task and cancel_task are free.

Is it safe to run my own CadQuery script?

Scripts run in an isolated worker with no network access, no credentials, and hard memory and time limits. Each worker instance runs a single job and is then discarded. A job can run for up to 10 minutes.

What happens when a build takes a while?

Results come back directly when the work finishes within about 20 seconds. Longer work returns a task_id: call get_task with wait_seconds 55 until it completes. Tasks survive restarts and wait in a queue when every engine is busy, so nothing needs to be resubmitted, and cancel_task stops a job.

Which file formats can it import and export?

It exports STEP, BREP, STL, 3MF, AMF, GLB, glTF, VRML, VTP, DXF cross sections and SVG line drawings. It imports STEP or STP (assemblies keep their body names and colors), BREP, and DXF profiles that you can extrude into solids.

Parametric Part Designer

Available ActionsEach successful request consumes credits as outlined below.

Details

Workflows Using This Tool

Engineering Drawings to Verified STEP Models

Use Cases

Dynamic MCP Setup

30 Second Setup

Hosted Streamable HTTPS

Config Example

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Can I change a part after it is built?

Can it check that parts fit together?

Do I need a CAD program or an Onshape account?

How do I know a generated part has the right dimensions?

How long are files kept, and what does it cost?

Is it safe to run my own CadQuery script?

What happens when a build takes a while?

Which file formats can it import and export?

Looking for help integrating AI into your business? Set up a free consultation.