About TechDraw AI
TechDraw AI Skills provides agent skills and an MCP server for turning photos or written descriptions into technical drawings, CAD files, 3D meshes, and product renders. It is for users creating engineering documentation with their own TechDraw AI API key.
Key features
- 01Photo- and text-based technical drawings
- 02DXF and optional DWG generation
- 03Printable STL and 3D mesh generation
- 04Product rendering from drawings
- 05Results saved to disk with returned paths
Use cases
- 01Create a dimensioned drawing from a part photo
- 02Convert an image into CAD contours
- 03Generate 3D models from photos or drawings
- 04Render a technical drawing as a product image
MCP support
The MCP server exposes drawing, CAD, 3D modeling, rendering, product identification, and credit-check tools to MCP clients. Each user authenticates with a TechDraw AI API key.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y techdrawai-mcpTECHDRAWAI_API_KEYSecretYour TechDraw AI API key (tda_sk_...). Requires an active Studio plan. Create one at https://techdrawai.com/app?view=settings, or run `npx -y techdrawai-mcp auth login` to sign in through the browser instead.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
6Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| image | string | Yes | The product photo: a local file path, an http(s) URL, or a data:image/…;base64,… URL. |
| notes | string | No | Anything else to state on the drawing (material, finish, tolerances). |
| units | enum | No | Primary drawing unit. Defaults to mm.mm | cm | m | in |
| views | array | No | Which views to include. Defaults to front, top and side. |
| standard | enum | No | Drafting standard. ISO (default) or ANSI.ISO | ANSI |
| paper_size | string | No | Sheet size: A4/A3/A2/A1/A0 for ISO (default A3), or "ANSI A"…"ANSI E" for ANSI (default "ANSI B"). |
| projection | enum | No | Projection angle. first-angle (default, ISO/Europe) or third-angle (ANSI/North America).first-angle | third-angle |
| output_path | string | No | Where to save the drawing. Defaults to ./techdrawai-output/drawing-<timestamp>.png. |
| drawing_type | enum | No | working = fully dimensioned production drawing (default); assembly = numbered balloons + parts list; as-fitted = record of the item as built; patent = numbered figure, no dimensions.working | assembly | as-fitted | patent |
| measurements | array | No | Dimensions actually measured on the object. Every other feature is scaled proportionally from these, so one accurate measurement makes the whole drawing accurate. |
| product_name | string | No | What the object is, e.g. "oak dining chair". Improves the title block and the estimated dimensions. Use `identify_product` first if you do not know. |
| estimate_dimensions | boolean | No | Let the model infer realistic real-world dimensions. Defaults to true when no measurements are given, false when they are. |
Details
From the project READMETechDraw AI Skills
AI agent skills for turning a photograph of a physical part into engineering documentation with TechDraw AI. Draft a dimensioned 2D technical drawing, trace it into CAD-ready DXF and DWG, reconstruct the part as a 3D mesh, or render it as a finished product shot. Works with Claude Code, Claude Desktop, Cursor, Codex, VS Code, Windsurf and anything else that loads Markdown skills or speaks MCP.
Each user authenticates with their own TechDraw AI API key, and every generation is billed to their account credits. The skills call the public TechDraw AI API directly, so there is nothing extra to install and no CAD kernel to build.
One photograph, three outputs: a dimensioned drawing, CAD geometry, and a 3D model.
Install
Pick one. Each method sets the skills up for your agent.
npx skills (recommended, cross-agent)
npx skills add MeltFlexDevs/techdrawai-skills
GitHub CLI (v2.90+)
gh skill install MeltFlexDevs/techdrawai-skills
Claude Code marketplace
Inside Claude Code:
/plugin marketplace add MeltFlexDevs/techdrawai-skills
/plugin install techdrawai@techdrawai
MCP server only
If you want the tools without the skills, add the MCP server directly:
claude mcp add techdrawai -- npx -y techdrawai-mcp
Configuration for Cursor, Claude Desktop, Codex, VS Code and Windsurf is on the MCP page.
Setup script
Universal fallback:
git clone --depth 1 https://github.com/MeltFlexDevs/techdrawai-skills.git
cd techdrawai-skills
./setup
More options in INSTALL.md. Agent-driven install, to paste into your agent: INSTALL_FOR_AGENTS.md.
Authenticate
Programmatic access is part of the Studio plan. Once you are subscribed, the simplest way to sign in is the browser flow, which mints a key from your session and hands it back over loopback so you never copy or paste a secret:
npx -y techdrawai-mcp auth login
Or create one by hand at techdrawai.com/app → Settings → API keys and export it:
export TECHDRAWAI_API_KEY="tda_sk_..."
The key is shown exactly once at creation. Only its SHA-256 is stored, so nobody can recover it afterwards, including us. An account may hold five live keys and revoking one takes effect on the next request.
Skills
| Skill | Invoke | What it covers |
|---|---|---|
techdrawai-drafting | /techdrawai:drafting | Photo or written description to dimensioned technical drawing. Drafting standard, sheet size, projection angle, drawing type, views, and the measurements that anchor the scale. |
techdrawai-cad | /techdrawai:cad | Everything downstream of the drawing: DXF and DWG at true size, printable STL, 3D reconstruction from a photo or a drawing, and product renders. |
Tools
| Tool | What it does | Cost |
|---|---|---|
generate_technical_drawing | Photo to a dimensioned, standards-compliant technical drawing | 5 credits |
text_to_technical_drawing | A written description with sizes to a dimensioned technical drawing, no photo | 5 credits |
image_to_dxf | Any image to real CAD contours as DXF, optionally DWG | Free |
image_to_stl | Flat artwork (logo, stencil, line drawing) extruded into a printable STL | Free |
render_product | Technical drawing to a photorealistic product render | 5 credits |
photo_to_3d | Photo to a textured 3D mesh, GLB plus FBX, OBJ, USDZ, STL | 80 credits |
drawing_to_3d | Technical drawing to a textured 3D mesh, one call and one charge | 80 credits |
identify_product | Name the object in a photo | Free |
check_credits | Balance, plan, and what each operation costs | Free |
Failed generations are refunded automatically, so an agent that retries a bad prompt does not quietly drain the balance.
Every tool writes its result to disk (./techdrawai-output/ unless you pass output_path) and returns the path rather than the bytes. A technical drawing is a megabyte-scale image, and pushing that through the protocol would burn the agent's context on something it usually just hands to the next tool.
What it looks like in practice
You: Here is a bracket,
~/photos/bracket.jpg. It is 120 mm across. I need a DXF for the laser cutter.
[identify_product] → "steel wall bracket"
[generate_technical_drawing]
product_name: "steel wall bracket"
measurements: [{ value: "120", unit: "mm", position: "overall width" }]
standard: ISO · paper_size: A3 · drawing_type: working
→ ./techdrawai-output/drawing-2026-07-27_15-04-11.png 5 credits
[image_to_dxf] width_mm: 120
→ ./techdrawai-output/drawing-2026-07-27_15-04-11.dxf 34 contours, free
The DXF arrives at true size, so it goes straight to the cutter without rescaling. More patterns in COOKBOOK.md.
One measurement changes everything
Without a real measurement the dimensions are the model's best estimate and are marked nominal. With even one, every other feature is scaled proportionally from it and the whole drawing becomes internally consistent and manufacturable. If a user has not given one, ask for it. It is the single biggest quality lever in the whole workflow.
The CLI
The same package is a command-line tool when you run it with arguments instead of letting an agent speak MCP to it:
techdrawai draw -i bracket.jpg --measure 120:"overall width" --paper A3
techdrawai dxf -i drawing.png --width-mm 120 --dwg
techdrawai model3d -i bracket.jpg --detail high
Full reference at techdrawai.com/cli.
Documentation
- API reference: every endpoint, request and response
- CLI: every command and flag
- MCP: client-by-client setup
- COOKBOOK.md: worked examples
- CONTRIBUTING.md
Licence
MIT. See LICENSE.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.