Img2CAD

Img2CAD for agents and developers

Use Img2CAD from AI agents and scripts

Img2CAD has an MCP server and a small REST API. Connect your AI agent once, then ask it to turn a photo into a CAD model: it sends the photo, waits for the model and hands you the STEP, STL and GLB files. Agents use your plan and export packs, exactly like the web app.

Agent access needs an Img2CAD plan or an export pack. See pricing.

1. Connect your agent

The MCP server is at https://img2cad.app/api/mcp (streamable HTTP). Most MCP clients sign you in to Img2CAD themselves: add the server, and the first time it's used you sign in to Img2CAD and choose Allow on a screen that shows what the app will be able to do. No key to copy.

Claude and ChatGPT

Add a custom connector (in ChatGPT, an app or connector in developer mode) with the URL https://img2cad.app/api/mcp and OAuth sign-in. Then sign in to Img2CAD when asked.

Claude Code

claude mcp add --transport http img2cad https://img2cad.app/api/mcp

Then run /mcp in Claude Code and choose Img2CAD to sign in.

Cursor

Add this to ~/.cursor/mcp.json, then sign in from Cursor's MCP settings:

{
  "mcpServers": {
    "img2cad": { "url": "https://img2cad.app/api/mcp" }
  }
}

VS Code

Add this to .vscode/mcp.json; VS Code asks you to sign in the first time:

{
  "servers": {
    "img2cad": { "type": "http", "url": "https://img2cad.app/api/mcp" }
  }
}

Connected apps are listed on the Account page of the web app, where you can disconnect them at any time.

2. Or use a personal API key

For scripts, the REST API, and clients that can't sign in, use a key instead:

  1. Sign in at img2cad.app/app and open Account.
  2. Under API keys for AI agents, choose Create API key and give it a name, such as "Claude on my laptop".
  3. Copy the key. It starts with i2c_ and is shown only once.

Send it as the header Authorization: Bearer i2c_..., for example in Claude Code:

claude mcp add --transport http img2cad https://img2cad.app/api/mcp \
  --header "Authorization: Bearer i2c_YOUR_KEY"

For clients that only start local servers, a bridge such as mcp-remote can pass the header:

npx mcp-remote https://img2cad.app/api/mcp --header "Authorization: Bearer i2c_YOUR_KEY"

A key, like a connected app, can create and read models on your account and spend its exports. It can't change your plan, billing, keys or account. Revoke a key on the Account page at any time; it stops working straight away.

3. Ask for a model

Once connected, just ask, for example: "Turn this photo into a STEP file: https://example.com/bracket.jpg. It's a wall bracket, 120 mm long." The agent starts the model, checks on it every half minute and gives you the download links when it's ready, usually within a few minutes. Then try: "Make the wall 3 mm thick and give me the new STL."

ToolWhat it doesUses an export
convert_photoStarts a model from a photo (a public link, an upload or a small inline image), with an optional object name and one real measurement for scaleYes, returned if it fails
get_modelProgress, then download links for STEP, STL and GLB, the overall size and the editable dimensionsNo
edit_dimensionsA new version with changed dimensions, such as height or wall thicknessNo (daily limit)
refine_modelA new version with a change described in words, while the photo is kept (24 hours)Yes, returned if it fails
list_modelsYour recent modelsNo
get_accountYour plan and how many exports are leftNo
create_upload_linkA short-lived upload link (15 minutes), so an agent that can run commands can send a photo from your computerNo

REST API

The same features over HTTPS, for scripts and your own tools. Base URL https://img2cad.app/api/v1; every request sends a personal API key as Authorization: Bearer i2c_.... The OpenAPI description is at /api/v1/openapi.json.

# 1. Upload a photo (JPEG, PNG or WebP, up to 20 MB)
curl -s https://img2cad.app/api/v1/photos \
  -H "Authorization: Bearer $IMG2CAD_API_KEY" \
  -H "Content-Type: image/jpeg" --data-binary @bracket.jpg
# {"upload_id": "UPLOAD_ID", ...}
# Or let Img2CAD fetch a public image:
#   -H "Content-Type: application/json" -d '{"image_url": "https://..."}'

# 2. Start the model (the name and the largest dimension in mm are optional)
curl -s https://img2cad.app/api/v1/jobs \
  -H "Authorization: Bearer $IMG2CAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"upload_id": "UPLOAD_ID", "object_label": "wall bracket", "dimension_hint_mm": 120}'
# {"id": "JOB_ID", "status": "queued", ...}

# 3. Check every 20 to 30 seconds until status is "succeeded"
curl -s https://img2cad.app/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $IMG2CAD_API_KEY"

# 4. Download links for STEP, STL and GLB (each valid for 15 minutes)
curl -s https://img2cad.app/api/v1/jobs/JOB_ID/artifacts \
  -H "Authorization: Bearer $IMG2CAD_API_KEY"

More endpoints:

  • GET /v1/jobs: your models, newest first.
  • GET /v1/jobs/{id}/parameters and POST /v1/jobs/{id}/variants with {"values": {"wall": 3}}: read and change a model's dimensions (free).
  • POST /v1/jobs/{id}/refine with {"note": "add a hole in the middle"}: a new version with a described change (one export).
  • DELETE /v1/jobs/{id}: cancel a model that hasn't started yet; the export is returned.
  • GET /v1/me/entitlements: plan and exports left.

Errors are JSON with a sentence you can show and a stable code, for example {"detail": "No included or purchased exports remain", "code": "quota_exhausted"}. Other codes include concurrency_limit, daily_limit, api_key_daily_limit, photo_unsupported and photo_too_large.

Limits and pricing

  • Agent access needs a paid plan or an export pack.
  • Each conversion or refinement uses one export: your plan's exports for the day first, then export packs. A failed conversion is returned automatically.
  • Dimension edits are free, with a daily limit.
  • One conversion runs at a time (two on the Studio plan); start the next one when the first is done.
  • Each API key or connected app can make 120 requests a minute and start 10 conversions a day. Each account can start up to 20 conversions a day and send up to 30 photos an hour.
  • Photos are deleted after 24 hours; models and their files are kept for 30 days.

Plans and export packs are the same as in the app: see pricing.

Questions

Does using Img2CAD through an agent cost extra?

No. An agent uses the same exports as the web app: your plan's daily exports first, then export packs. Dimension edits are free, and a failed conversion never uses an export.

Is it safe to connect an agent?

A connected app or API key can only create and read models and spend your exports; it can't change billing, keys or your account. Signing in is the safest option because no key is copied. If you use a key, put it in your agent's settings rather than pasting it into a chat. Disconnect apps and revoke keys on the Account page at any time.

Can the agent use a photo I attach in the chat?

A photo with a public link works with any agent. Agents that run on your computer, such as Claude Code or Cursor, can also send a local photo through a short-lived upload link. Chat apps that show the agent the picture but not the file can't pass it on yet.

How long does a model take?

Usually a few minutes. The agent checks on it every 20 to 30 seconds and tells you when the files are ready. Dimension edits take about a minute.

Open Img2CAD