# QR code reader

Read the text or link stored in a QR code from a picture or screenshot, and show where each code is.

Looks for QR codes in the picture and returns what each one holds. If nothing is found at first, it tries again with an enlarged copy and with the colours inverted.

- Endpoint: `POST https://setget.net/v1/tools/qr-decode` with JSON `{"input": {...}}` (add `"wait": 30` to hold the reply until the job finishes)
- MCP: `run_tool` with `slug` = `qr-decode`
- Page: https://setget.net/tools/qr-decode

## Files in, files out

This is a file tool. Its file inputs take file references, not file contents and not web addresses.

- Get a reference by uploading: `curl -T FILE https://setget.net/drop/` prints a line `ref  <id>/f1`. Or `POST https://setget.net/v1/drops` with `{"files":[{"name","size"}]}`, PUT the bytes to the returned `upload.url` with the listed headers, and use the file's `ref`. Over MCP use the `drop` tool. A file under about 700 KB can also be sent in place as a `data:<type>;base64,<content>` URI.
- Uploads are at most 100 MB per file, are readable by anyone with the link, and expire (one hour by default). Programs are refused.
- The tool runs as a job. The reply is `{"tool", "ms", "result", "files", "job"}`: `result` is JSON, and every result file comes back in `files` as `{"name", "size", "content_type", "kind", "url", "ref"}`. Download it from `url`, or pass `ref` as the input of another file tool.
- A job still running when the wait ends answers 202 with `job`. Follow it with `GET https://setget.net/v1/jobs/<id>?wait=30`, or stream progress from `GET https://setget.net/v1/jobs/<id>/events` (over MCP: the `job` tool). A person can watch it at `job.url`.

## Inputs

- `image` (required, file, a file reference such as `DROP_ID/f1`, accepts image): A picture that shows one or more QR codes.

## Example: Read a link from a QR code

Upload first. Each placeholder below stands for the reference of one upload: `DROP_ID/f1` = [sample-qr.png](https://setget.net/static/samples/sample-qr.png).

```json
{"input":{"image":"DROP_ID/f1"},"wait":30}
```

**What if the picture holds several codes?** Every code that can be read is returned, from top to bottom, each with its text and position. "text" at the top of the result is the first one.

**What do the position numbers mean?** They are pixels in the picture as a viewer shows it, measured from the top left corner: the box around the code, and its corner points.

**Why was no code found?** Usually the code is too small in the picture, blurred, cut off at an edge, or has no clear margin. Crop closer to the code or take a sharper picture. Light codes on a dark background and codes on a transparent background are handled.

**Does it open the link in the code?** No. The text is returned exactly as stored. Nothing is visited or checked.

**Which codes can it read?** Standard QR codes. For product and label barcodes use barcode-decode. Micro QR, Data Matrix and Aztec codes are not supported.
