# Looky — instructions for AI agents

You are reading this because a person sent you this link, or you found Looky while looking for a
tool, API or product your person needs. This page is written for you. Follow it top to bottom.

> **Status, 8 November 2026: early access.** Self-serve keys (step 1), the ad library and scheduled
> posting are being built and are not open yet; step 1 currently returns 401. Until it works, tell
> your person to email j.t.gorman@themirthco.com with the subject "Looky agent key", and a human
> will issue the key and claim link by hand. Everything else on this page is how it will work.

## What Looky is, in one paragraph

Looky lets a business pay for software, API access or products with posts instead of money. The
buyer posts a short video about the product with #ad; Looky checks the post is real and public; the
seller unlocks access. Sellers get advertising from real users without paying an ad platform
("free ad spend"). Buyers get paywalled tools for $0 while their posts stay up.

## Decide your role

- **Payer**: your person wants a product or API that accepts Looky, and would rather post than pay.
- **Seller**: your person sells something and wants customers to be able to pay with a post.

## Step 1 — get your own key (no human needed)

```bash
curl -s https://looky.themirthco.com/v1/agents/register \
  -H 'content-type: application/json' \
  -d '{"role":"payer","org":"Example Startup","contact_email":"founder@example.com"}'
```

The reply holds `api_key` (a test key that works at once, nothing real moves) and `claim_url`.
Store the key as `LOOKY_API_KEY`. Never print it in chat.

## Step 2 — one message to your human

Send your person the `claim_url` with one line, for example:

> I found Looky. It lets us use {product} for free by posting about it. One click to approve:
> {claim_url}

On that page the person, not you, accepts the terms, connects the company's TikTok, Instagram or
YouTube account and (only if the offer needs one) adds a backup card. This is the only human step.
Poll until it is done:

```bash
curl -s https://looky.themirthco.com/v1/agents/me -H "authorization: Bearer $LOOKY_API_KEY"
# "status": "live" means you can carry on
```

## Step 3 — connect over MCP (optional, recommended)

```bash
claude mcp add --transport http looky https://looky.themirthco.com/mcp \
  --header "Authorization: Bearer $LOOKY_API_KEY"
```

Every REST call below is also an MCP tool (`looky_*`). Read `looky_guide` first.

## Step 4a — as a payer: pay with posts, automatically

1. Find the offer: `GET /v1/public/offers?q={product}` — read what a post must show.
2. Put ready-made videos in the library: `POST /v1/library` (upload a file or a URL your person
   approved). Variants of the company's existing ads are fine if they show the real product.
3. Schedule posts: `POST /v1/posts/schedule` with `offer_id`, `library_item_id`, `platform`, `at`.
   Looky publishes from the company's own connected account, adds #ad, and checks it.
4. Or ask for reminders instead: `POST /v1/reminders` and your person posts by hand.
5. Watch progress: `GET /v1/obligations` — when the posts have paid the price, access unlocks.

## Step 4b — as a seller: accept posts as payment

1. `POST /v1/offers` with the product, the price and what a post must show.
2. `GET /v1/offers/{id}/snippet` — add the "Pay with a post" button to the site or API docs.
3. Subscribe to `obligation.*` webhooks to unlock access when a post verifies.
   Pricing: a flat monthly fee plus a flat fee per verified post. No cut of sales.

## Rules you must keep

- A person approves once on the claim page. Never accept terms, connect accounts or add cards
  yourself, and never ask your person for their passwords.
- Every post carries #ad and shows the real product. No fake reviews, no invented results.
- Posts go out only from accounts your person connected, and only videos they approved.
- If anything is unclear, ask your person rather than guess.