← Preview Lab

Let your AI agent send preview links

Connect any assistant (Claude, ChatGPT, your own agent such as Instinct) to Preview Lab. It asks for a message, gets back the text and a link, and sends it. The link unfurls into a branded card, and every tap is counted.

1. You ask your agent
2. Agent calls compose_preview
3. Gets text + link
4. Texts it
5. Phone shows the card
6. Tap → your page, click counted

Replace YOUR_API_KEY with this server’s API key. Keep it secret: anyone with it can publish links.

Try it

Edit the JSON an agent would send, then preview it. This is a dry run: nothing is published.

{ "brand": "kinetic", "messageType": "offer", "details": { "deal": "25% OFF", "on": "your first 3 months", "ends": "Ends Sunday", "code": "KINETIC25" }, "angle": "personal", "text": "Kinetic: Thanks for the call, {name}! 25% off your first 3 months. Code KINETIC25.", "recipientName": "Sam", "dryRun": true }

Preview

1. MCP (recommended)

Endpoint: https://getpreviewlab.com/mcp (Streamable HTTP, Authorization: Bearer key).

Claude Code:

claude mcp add --transport http preview-lab https://getpreviewlab.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Other MCP clients (Cursor, agent frameworks, Instinct):

{
  "mcpServers": {
    "preview-lab": {
      "type": "http",
      "url": "https://getpreviewlab.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude.ai and ChatGPT connectors sign in with OAuth, which Preview Lab does not support yet. Use Claude Code, an agent framework, or the REST API below.

2. One REST call

curl -X POST https://getpreviewlab.com/api/compose \
  -H 'content-type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "brand": "kinetic",
    "messageType": "offer",
    "details": { "deal": "25% OFF", "on": "your first 3 months", "ends": "Ends Sunday", "code": "KINETIC25" },
    "angle": "personal",
    "text": "Kinetic: Thanks for the call, {name}! 25% off your first 3 months. Code KINETIC25. Reply STOP to opt out",
    "recipientName": "Sam",
    "targetUrl": "https://example.com/kinetic/join"
  }'

Reply:

{
  "cardId": "aS2rH5pr",
  "url": "https://getpreviewlab.com/l/aS2rH5pr",
  "text": "Kinetic: Thanks for the call, Sam! 25% off … https://getpreviewlab.com/l/aS2rH5pr",
  "destination": "https://example.com/kinetic/join",
  …
}

Missing details fail with a clear message, so an agent never sends sample data. Also: POST /api/sequences, POST /api/tests, GET /api/catalog. Full list in the README.

3. Full control: any card, photos, motion, the link itself

Start from a message type, a promo, an existing link, or a blank card with a title, and set any part of the design, or just a look (neon, sunset-pop, editorial, luxe, ocean, candy, retro, mono, forest, arcade, memo). Every limit matches the editor (GET /api/card-options lists them, no key needed). No key yet? POST /api/looks and POST /api/preview (MCP try_looks, preview_card) draw cards for anyone, and /looks shows your words in every look.

curl -X POST https://getpreviewlab.com/api/links \
  -H 'content-type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "from": { "promo": "percent-off", "brand": "Kinetic", "offer": "30% off" },
    "design": { "template": "blast", "badge": "TODAY", "cta": "Shop now →",
                "colors": { "bg1": "#0b1d2a", "bg2": "#123b52", "accent": "#c6ff1a" } },
    "motion": { "preset": "count", "number": "30%" },
    "targetUrl": "https://kinetic.example/sale"
  }'

Library documents open through a share link: /l/{linkId} leads to /d/{id}?s={linkId} (page images, find in the document, download if allowed). New documents are private: the plain /d/{id} opens only when openLink is on. The card at /d/{id}/og.jpg is always public. Reviewing the site? Start with What's new and /llms.txt.

Retrying a write? Send Idempotency-Key: <8–128 letters, digits, _ or -> on any /api/ write: a retry gets the first answer (Idempotent-Replayed: true), never a second link; the same key with a different request is a 409. Colours you pick must read at 4.5:1 (WCAG AA), or the card is refused with the ratio.

Paused links keep their preview, but a tap lands on a “paused” page and is not counted. iMessage gets the MP4, Discord the GIF, everyone else the still JPEG, until the render is ready.

4. Build the link yourself (signed)

An agent that holds the key can write a promo link with no API call. The server checks the signature, builds the card on the first open, and counts taps. Changing any field breaks the link, so nobody can point your card somewhere else.

https://getpreviewlab.com/t/<promo>?brand=…&offer=…&code=…&url=…&ends=…&angle=…&sig=…

Signature: HMAC-SHA256 with your API key, over <promo>? plus the fields that have a value, in the order angle, brand, code, color, ends, offer, url, v, written name=value with strict URL encoding (only A–Z a–z 0–9 - _ . ~ stay as is), joined by &. Keep the first 32 hex characters. Promo ids: GET /api/promos.

import { createHmac } from 'node:crypto';
const enc = (s) => encodeURIComponent(s).replace(/[!'()*]/g, (c) => '%' + c.charCodeAt(0).toString(16).toUpperCase());

function promoLink(key, promo, fields) {
  const names = ['angle', 'brand', 'code', 'color', 'ends', 'offer', 'url', 'v'].filter((k) => fields[k]);
  const query = names.map((k) => k + '=' + enc(fields[k])).join('&');
  const sig = createHmac('sha256', key).update(promo + '?' + query).digest('hex').slice(0, 32);
  return 'https://getpreviewlab.com/t/' + promo + '?' + query + '&sig=' + sig;
}

promoLink(KEY, 'flash-sale', { brand: 'Orbit', offer: '20% off all cold brew', code: 'BREW20', ends: 'This weekend', url: 'https://orbit.example' });

import hashlib, hmac
from urllib.parse import quote

def promo_link(key, promo, **fields):
    names = [k for k in ['angle', 'brand', 'code', 'color', 'ends', 'offer', 'url', 'v'] if fields.get(k)]
    query = '&'.join(f"{k}={quote(str(fields[k]), safe='')}" for k in names)
    sig = hmac.new(key.encode(), f'{promo}?{query}'.encode(), hashlib.sha256).hexdigest()[:32]
    return f'https://getpreviewlab.com/t/{promo}?{query}&sig={sig}'

Check your code against POST /api/promos/sign (same fields, key required): it returns the same link.

Tools

Sending rules

Preview Lab makes the links; your agent or app sends the texts. Text only people who opted in, 8 AM–9 PM in their time zone, and stop when they reply, buy or text STOP.