# 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](https://img2cad.app/#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](https://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."

| Tool | What it does | Uses an export |
|---|---|---|
| `convert_photo` | Starts 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 scale | Yes, returned if it fails |
| `get_model` | Progress, then download links for STEP, STL and GLB, the overall size and the editable dimensions | No |
| `edit_dimensions` | A new version with changed dimensions, such as height or wall thickness | No (daily limit) |
| `refine_model` | A new version with a change described in words, while the photo is kept (24 hours) | Yes, returned if it fails |
| `list_models` | Your recent models | No |
| `get_account` | Your plan and how many exports are left | No |
| `create_upload_link` | A short-lived upload link (15 minutes), so an agent that can run commands can send a photo from your computer | No |

## 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](https://img2cad.app/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](https://img2cad.app/#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.

---

Source: https://img2cad.app/agents
