{"openapi": "3.1.0", "info": {"title": "KinetiCAD agent API", "version": "1.0.0", "summary": "Get a part checked and priced, then request a CNC machining order.", "description": "The same operations as the MCP server at https://get.kineticad.ai/mcp. No API key. Guide: https://get.kineticad.ai/agents.md", "contact": {"email": "contact@kineticad.ai", "url": "https://get.kineticad.ai/agents"}}, "servers": [{"url": "https://get.kineticad.ai/api/agent"}], "paths": {"/parts": {"post": {"operationId": "buildPart", "summary": "Send a part as CadQuery code or as a STEP file", "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["cadquery"], "properties": {"cadquery": {"type": "string", "description": "CadQuery (Python) code for one part, in millimeters."}, "name": {"type": "string", "description": "Short name of the part, for example: Motor bracket."}, "about": {"type": "string", "description": "One sentence on what the part is for. The KinetiCAD team sees it with an order request."}}}}, "multipart/form-data": {"schema": {"type": "object", "required": ["file"], "properties": {"file": {"type": "string", "format": "binary", "description": "A STEP file, up to 8 MB, one part."}, "name": {"type": "string"}, "about": {"type": "string"}}}}}}, "responses": {"201": {"description": "The part was built and checked.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Part"}}}}, "422": {"description": "The request could not be completed. The message says what to change.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "429": {"description": "The request could not be completed. The message says what to change.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}}}}, "/parts/{part_id}": {"get": {"operationId": "getPart", "summary": "The measured facts of a part", "parameters": [{"name": "part_id", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^[a-z0-9]{24}$"}}], "responses": {"200": {"description": "The part.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Part"}}}}, "404": {"description": "The request could not be completed. The message says what to change.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}}}}, "/parts/{part_id}/picture.png": {"get": {"operationId": "viewPart", "summary": "A picture of the part from one side", "parameters": [{"name": "part_id", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^[a-z0-9]{24}$"}}, {"name": "view", "in": "query", "schema": {"type": "string", "enum": ["iso", "iso_back", "top", "bottom", "front", "back", "right", "left", "under"], "default": "iso"}}], "responses": {"200": {"description": "PNG, 640 x 480.", "content": {"image/png": {}}}, "404": {"description": "The request could not be completed. The message says what to change.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}}}}, "/parts/{part_id}/price": {"post": {"operationId": "pricePart", "summary": "The price and delivery date from a machining plan", "parameters": [{"name": "part_id", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^[a-z0-9]{24}$"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "properties": {"material": {"type": "string", "enum": ["aluminum-6061", "aluminum-7075", "steel-1045", "stainless-304", "acetal"], "default": "aluminum-6061", "description": "What the part is machined from."}, "quantity": {"type": "integer", "minimum": 1, "maximum": 1000, "default": 1, "description": "How many pieces."}, "wait_seconds": {"type": "integer", "minimum": 0, "maximum": 50, "default": 25, "description": "How long the call may wait for the engine's plan."}}}}}}, "responses": {"200": {"description": "The price, or the planning status.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Price"}}}}, "404": {"description": "The request could not be completed. The message says what to change.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}}}}, "/parts/{part_id}/order": {"post": {"operationId": "requestOrder", "summary": "Send an order request. No payment is taken", "parameters": [{"name": "part_id", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^[a-z0-9]{24}$"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["name", "email", "street", "city", "state", "zip"], "properties": {"quantity": {"type": "integer", "minimum": 1, "maximum": 1000, "default": 1, "description": "How many pieces."}, "material": {"type": "string", "enum": ["aluminum-6061", "aluminum-7075", "steel-1045", "stainless-304", "acetal"], "default": "aluminum-6061", "description": "What the part is machined from."}, "name": {"type": "string", "description": "The user's full name."}, "email": {"type": "string", "description": "Where KinetiCAD sends the confirmed price and delivery date."}, "street": {"type": "string", "description": "Shipping address: number and street."}, "city": {"type": "string"}, "state": {"type": "string", "description": "US state, two letters, for example CA."}, "zip": {"type": "string", "description": "US ZIP code."}, "phone": {"type": "string"}, "company": {"type": "string"}, "notes": {"type": "string", "description": "Anything the shop should know: threads, fits, finish, a date the parts are needed by."}}}}}}, "responses": {"200": {"description": "The order request was received.", "content": {"application/json": {"schema": {"type": "object"}}}}, "400": {"description": "The request could not be completed. The message says what to change.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}, "404": {"description": "The request could not be completed. The message says what to change.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}}}}, "/parts/{part_id}/download": {"post": {"operationId": "downloadPart", "summary": "A link to the STEP or STL file of the part", "parameters": [{"name": "part_id", "in": "path", "required": true, "schema": {"type": "string", "pattern": "^[a-z0-9]{24}$"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"type": "object", "required": ["email"], "properties": {"email": {"type": "string"}, "format": {"type": "string", "enum": ["step", "stl"], "default": "step"}}}}}}, "responses": {"200": {"description": "A link that works for 10 minutes.", "content": {"application/json": {"schema": {"type": "object", "properties": {"url": {"type": "string"}, "format": {"type": "string"}, "valid_minutes": {"type": "integer"}}}}}}, "404": {"description": "The request could not be completed. The message says what to change.", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Error"}}}}}}}, "/materials": {"get": {"operationId": "listMaterials", "summary": "The materials a part can be machined from", "responses": {"200": {"description": "The materials.", "content": {"application/json": {"schema": {"type": "object"}}}}}}}}, "components": {"schemas": {"Error": {"type": "object", "properties": {"error": {"type": "object", "properties": {"code": {"type": "string"}, "message": {"type": "string"}, "stage": {"type": "string"}, "line": {"type": "integer"}}}}}, "Part": {"type": "object", "properties": {"part_id": {"type": "string"}, "name": {"type": "string"}, "source": {"type": "string", "enum": ["script", "build", "step"]}, "size_mm": {"type": "array", "items": {"type": "number"}, "description": "Length along X, Y and Z."}, "volume_cm3": {"type": "number"}, "surface_cm2": {"type": "number"}, "faces": {"type": "integer"}, "features": {"type": "array", "items": {"type": "string"}, "description": "Round holes and round outside surfaces, measured on the solid."}, "warnings": {"type": "array", "items": {"type": "string"}}, "parameters": {"type": "array", "items": {"type": "object"}, "description": "The named dimensions of a script with PARAMS."}, "links": {"type": "object", "properties": {"see_in_3d": {"type": "string"}, "picture": {"type": "string"}}}, "kept_days": {"type": "integer"}}}, "Price": {"type": "object", "properties": {"part_id": {"type": "string"}, "status": {"type": "string", "enum": ["priced", "planning", "busy", "estimate"]}, "material": {"type": "string"}, "quantity": {"type": "integer"}, "currency": {"type": "string"}, "unit_price": {"type": "number"}, "total": {"type": "number"}, "cost_lines": {"type": "object"}, "plan": {"type": "object", "description": "Machines, setups, setup and cycle minutes, stock, steps, and watch_out: what makes the plan expensive or incomplete."}, "delivery_date": {"type": "string"}, "lead_time_business_days": {"type": "integer"}, "unit_price_range": {"type": "object", "properties": {"low": {"type": "number"}, "high": {"type": "number"}}}, "retry_after_seconds": {"type": "integer"}, "note": {"type": "string"}}}}}}