# Waitloop

> Agent-first waitlists: hosted signup pages with referral ranking, operated via MCP server, JSON-first CLI, and REST API. One API key (wl_...) unlocks all three. MCP endpoint: https://waitloop.dev/api/mcp (streamable HTTP, Bearer auth).

## Docs

- [Waitloop](https://waitloop.dev/docs/index.md)
- [MCP server](https://waitloop.dev/docs/mcp.md)
- [CLI](https://waitloop.dev/docs/cli.md)
- [REST API](https://waitloop.dev/docs/api.md)
- [Webhooks](https://waitloop.dev/docs/webhooks.md)
- [Embed widget](https://waitloop.dev/docs/embed.md)
- [Self-hosting](https://waitloop.dev/docs/self-hosting.md)

## Key facts

- Create a waitlist: MCP tool create_waitlist, CLI `npx waitloop-cli waitlists:create --name "..."`, or POST https://waitloop.dev/api/v1/waitlists
- Waitlists are referenced by UUID or slug everywhere
- Public signup endpoint (no auth, CORS-open): POST https://waitloop.dev/api/public/w/<slug>/signups with {"email": "..."}
- Hosted pages live at https://waitloop.dev/w/<slug>; referral links append ?ref=<code>
- Open source (AGPL-3.0), self-hostable: https://github.com/zexiro/waitloop