# Agent QR

> QR code generation infrastructure for AI agents

## Quick Start for Agents

### REST API (no signup required)

```
POST https://api.agentqr.tools/v1/qr
Content-Type: application/json

{
  "data": "https://example.com",
  "format": "png",
  "size": 300
}
```

First call returns an auto-provisioned API key in the response. Store it for future calls to get 1,000 free codes/month.

### MCP Server

Add to your MCP client config (Claude Code, Cursor, etc.):

```json
{
  "mcpServers": {
    "agent-qr": {
      "command": "npx",
      "args": ["-y", "@agent-qr/mcp"]
    }
  }
}
```

### CLI

```bash
npx @agent-qr/cli generate --url "https://example.com" -o qr.png
```

## API Endpoints

- `POST /v1/qr` — Generate a QR code (returns image + auto-provisioned API key on first call)
- `POST /v1/qr/batch` — Generate multiple QR codes (requires API key)
- `GET /` — Health check

## Formats

- `png` — base64 data URI (default)
- `svg` — raw SVG string
- `base64` — raw base64 string

## Options

- `data` (required) — The data to encode (URL, text, vCard, etc.)
- `size` — Image size in pixels (default: 300)
- `format` — Output format (default: png)
- `errorCorrectionLevel` — L, M, Q, H (default: M)
- `colorDark` — Foreground color in hex (default: #000000)
- `colorLight` — Background color in hex (default: #FFFFFF)

## Tiers

- **Free** (auto-provisioned): 1,000 codes/month, all generation features, no signup
- **Pro** ($10/mo): 10,000 codes/month, dynamic codes, analytics, webhooks

## Authentication

No API key needed for first call. The response includes an auto-provisioned key. Use it in the `X-API-Key` header for subsequent calls.

```http
X-API-Key: qr_live_xxxxxxxxxxxxxxxx
```

## Links

- API: https://api.agentqr.tools
- OpenAPI spec: https://agentqr.tools/openapi.json
- MCP config: https://agentqr.tools/.well-known/mcp.json
- npm: @agent-qr/core, @agent-qr/mcp, @agent-qr/cli