# Loopah — branded social content engine (loopah.good-scratch.com)

> Loopah learns a brand's look and voice, then generates, schedules, and
> publishes its social content (Instagram carousels, single-image posts, and
> reels). It is built to be driven by AI agents as well as people.

## For agents

Loopah exposes its core actions to AI agents two ways, both authenticated with a
Loopah API key (`loopah_sk_...`, sent as `Authorization: Bearer`). Keys are
scoped to specific brands and capabilities (generate / schedule / publish) and
are minted by an admin at https://loopah.good-scratch.com/g/autoposter/admin/keys

- **MCP server** (recommended): https://loopah.good-scratch.com/api/mcp
  Streamable HTTP. Tools: list_brands, list_ideas, generate_ideas,
  generate_carousel, generate_static, get_history, get_calendar,
  schedule_carousel, publish_carousel.
- **REST API**: described by https://loopah.good-scratch.com/openapi.json
  Catalog: https://loopah.good-scratch.com/.well-known/api-catalog

## Plans

- **Generation and download are free** (subject to trial credits).
- **Scheduling and publishing require a paid plan.** On the free plan, generate
  your posts, download them, and upload to Instagram yourself. `schedule_*` and
  `publish_*` return HTTP 402 (`paidPlanRequired`) with an upgrade pointer for
  free/trial brands.

## Notes

- `generate_*` tools cost trial credits; when exhausted the API returns HTTP 402
  (`creditsExhausted`) with a payment pointer.
- `publish_carousel` posts to a brand's real connected Instagram — use
  `dryRun: true` to validate first. It requires a paid brand AND a key with the
  `publish` capability.
- A typical flow: list_brands -> generate_carousel -> get_history (to get the
  carousel slug) -> publish_carousel (dryRun first).

## Key links

- Health: https://loopah.good-scratch.com/api/health
- MCP server card: https://loopah.good-scratch.com/.well-known/mcp/server-card.json
- OpenAPI: https://loopah.good-scratch.com/openapi.json