npm techdrawai-mcpstdioMITupdated 1mo ago
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.
What can you do with TechDraw AI?
TechDraw 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.
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 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, 3D reconstruction, and product renders. |
Tools
| Tool | What it does | Cost |
|---|---|---|
generate_technical_drawing |
Photo to a dimensioned, standards-compliant technical drawing | 3 credits |
image_to_dxf |
Any image to real CAD contours as DXF, optionally DWG | Free |
render_product |
Technical drawing to a photorealistic product render | 3 credits |
photo_to_3d |
Photo to a textured 3D mesh, GLB plus FBX, OBJ, USDZ, STL | 3 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 3 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.
Install
Add TechDraw AI to your client. Pick the one you use.
claude mcp add techdrawai-mcp -- npx -y techdrawai-mcpcodex mcp add techdrawai-mcp -- npx -y techdrawai-mcpamp mcp add techdrawai-mcp -- npx -y techdrawai-mcp{
"mcpServers": {
"techdrawai-mcp": {
"command": "npx",
"args": [
"-y",
"techdrawai-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"techdrawai-mcp": {
"command": "npx",
"args": [
"-y",
"techdrawai-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"techdrawai-mcp","command":"npx","args":["-y","techdrawai-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"techdrawai-mcp": {
"command": "npx",
"args": [
"-y",
"techdrawai-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"techdrawai-mcp": {
"command": "npx",
"args": [
"-y",
"techdrawai-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"techdrawai-mcp": {
"command": "npx",
"args": [
"-y",
"techdrawai-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"techdrawai-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"techdrawai-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"techdrawai-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"techdrawai-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y techdrawai-mcpRun `goose configure`, choose **Add Extension โ Command-line Extension**, and paste this command.
6 tools
TechDraw AI exposes 6 tools to a connected agent.
- generate_technical_drawing
- Photo to a dimensioned, standards-compliant technical drawing
- image_to_dxf
- Any image to real CAD contours as DXF, optionally DWG
- render_product
- Technical drawing to a photorealistic product render
- photo_to_3d
- Photo to a textured 3D mesh, GLB plus FBX, OBJ, USDZ, STL
- identify_product
- Name the object in a photo
- check_credits
- Balance, plan, and what each operation costs
Score
75 / 100
Good
- Documentation25/25
- Maintenance16/25
- Trust16/20
- Capability6/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 35 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 6 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint โ no local install
Version history
| Versions | Published |
|---|---|
| 0.1.1Latest | Jul 28, 2026 |
| 0.1.0 | Jul 28, 2026 |