Render a print-ready poster around one QR
qr_posterWrap one QR design in a print-ready poster: a4/a5/a6/letter trim, four layouts (minimal, band, card, tent), headline, instruction line, footer, optional logo, 3 mm bleed and crop marks. Returns a vector PDF by default (ready for a print shop) or a png preview at 36-300 dpi. Useful for a table card, a shop window or a hotel desk. The design fields are the same qr_generate takes; fileFormat is the poster's own format, not the code's.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"content": "<content>"
},
"name": "qr_poster"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dpi | No | Resolution of a png poster, 36-300 dpi. Ignored for pdf. | |
| text | No | Optional caption rendered below the QR (e.g. a slogan). | |
| bleed | No | Add a 3 mm bleed around the trim. Recommended for professional printing. | |
| footer | No | Small footer under the poster (website, short URL). Blank: none. | |
| content | Yes | The text or URL the QR will encode. Required. | |
| logoUrl | No | Public HTTPS URL of a logo image to embed at the center. | |
| eccLevel | No | Error-correction level (L=7%, M=15%, Q=25%, H=30%). Higher levels survive more damage but are denser. | |
| headline | No | Large title above the QR. Blank: none. | |
| showLogo | No | Draw the design's logo at the top of the poster. Defaults to true. | |
| cropMarks | No | Draw crop marks outside the trim. | |
| frameText | No | Label inside the frame, max 40 characters, any language (e.g. "Scan me", "View the menu"). Defaults to "Scan me". | |
| fileFormat | No | Poster output. Defaults to "pdf" (vector, print-ready); "png" is a raster preview. | |
| frameColor | No | Frame colour in hex, also the label background. Defaults to "#000000". | |
| frameStyle | No | Call-to-action frame around the whole QR with a short label. Never covers the QR or its quiet zone. | |
| accentColor | No | Brand colour for the headline, band and card border (hex). Defaults to the frame or module colour. | |
| instruction | No | Short line under the QR (e.g. "Point your camera at the code"). Blank: none. | |
| moduleShape | No | Shape of the small modules in the QR matrix. | |
| outputWidth | No | Output width in pixels (raster) or viewport units (svg). 64-4096. | |
| outputHeight | No | Output height in pixels (raster) or viewport units (svg). 64-4096. | |
| posterFormat | No | Trim size, portrait. Defaults to a4. | |
| posterLayout | No | Poster layout around the code. Defaults to minimal. | |
| primaryColor | No | Foreground/module color in hex (e.g. "#000000" or "#0a84ff"). | |
| frameTextColor | No | Frame label colour in hex. Defaults to "#FFFFFF". | |
| backgroundColor | No | Background color in hex (e.g. "#ffffff"). Use "transparent" for no background. | |
| additionalConfig | No | Escape hatch: any other QrConfig field the engine accepts (gradient stops, dot rotation, etc.). Merged on top of the structured fields above. | |
| finderInnerShape | No | Shape of the inner dot of the three corner finder patterns. | |
| finderOuterShape | No | Shape of the outer ring of the three corner finder patterns. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dpi | No | Raster resolution, when the output is a png. | |
| format | Yes | Poster file: "pdf" or "png". | |
| content | No | What the QR encodes. | |
| mimeType | No | MIME type of the poster. | |
| sizeBytes | No | Poster size in bytes. | |
| resourceUri | No | URI of the embedded PDF resource. PDFs cannot be inlined, so the file travels as a resource block. | |
| posterFormat | No | Trim size used (a4, a5, a6, letter). | |
| posterLayout | No | Layout used (minimal, band, card, tent). |