Model Context Protocol · v1.1.0

MCP Integration

Any AI agent can generate shaped QR codes on demand. One JSON-RPC call. Clean black-and-white output. 1 ink per QR.

START HERE — use generate_geometric_qr This is the primary tool. Fast, deterministic, clean B&W output shaped to any silhouette. 1 ink per QR. generate_geometric_qr is the AI-painted version — slower, colorful, 5 ink — only use it if you specifically want artistic diffusion output.

Endpoint

POST https://shapedqr.com/api/qr-studio-mcp
Content-Type: application/json
X-MCP-Source: your-agent-name

generate_geometric_qr PRIMARY · 1 ink · 10 free trials

Clean black-and-white QR clipped to a shape. Deterministic. Fast. This is what most agents want.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_geometric_qr",
    "arguments": {
      "url": "https://yoursite.com",
      "email": "agent@yourdomain.com",
      "shape_preset": "bb"
    }
  }
}

Field	Required	Notes
url	required	The URL to encode. https://, tel:, wifi:, sms: all supported.
email	required	Billing identifier. New emails get 50 free ink on first call.
shape_preset	one of	Preset key from `list_shapes`. e.g. bb, skull, heart, star5, dt, crown, hexagon…
shape_svg_path	one of	Custom SVG `d` attribute for your own silhouette. +1 ink.

list_shapes FREE · 0 ink

Returns all available shape preset keys. Call once to discover what's available before generating.

{
  "jsonrpc": "2.0", "id": 1,
  "method": "tools/call",
  "params": { "name": "list_shapes", "arguments": {} }
}

generate_multi_qr 1 ink per real QR · 5 free trials

Multiple QRs inside one shape. Mix real scannable QRs with decoys — broken-finder fakes that look like QRs but don't scan, defeating bot scrapers while humans find the real one.

{
  "jsonrpc": "2.0", "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_multi_qr",
    "arguments": {
      "url": "https://yoursite.com",
      "email": "agent@yourdomain.com",
      "shape_preset": "bb",
      "extra_qrs": [
        { "decoy": true },
        { "decoy": true }
      ]
    }
  }
}

AI-diffusion painted QR. Artistic, colorful, slower. Use only when you want painterly output — not for standard shaped QR generation.

Response

{
  "ok": true,
  "svg": "<svg ...>",
  "scannable": true,
  "ink_charged": 1,
  "remaining_balance": 49
}

Auto-refund on failure Ink is only charged on success. Failed generations auto-refund. New agents get 50 free ink on first call — enough for 10 geometric QRs or 5 multi-QRs.

Pricing

1 ink = $0.05. generate_geometric_qr costs 1 ink ($0.05). generate_geometric_qr costs 5 ink ($0.25). list_shapes and validate_geometric_layout are free. Top up at inkwell.wiki/buy-ink.