Referrals

Every signup now gets a referral code, and Enlist tracks who referred whom. You decide what a referral is worth — Enlist just keeps the count honest.

What's included:

• Signup response: POST /v1/waitlists/:id/signups returns referral_code, ten URL-safe characters. Put it behind ?ref= and you have a share link.
• Signup request: pass someone else's code as referral_code and their referral_count goes up, inside the same transaction that assigns the position.
• Signup shape: referral_code, referral_count, and referred_by are on every signup returned by the API and the SDK.
• MCP: add_signup takes an optional referralCode, so an agent wiring up a form can pass the ref param straight through.

Positions never change. A referral does not move anyone up the list — it increments a counter you can sort by, threshold on, or subtract from the number you display. That keeps position meaning exactly one thing: the order people joined in.

An unknown, malformed, wrong-waitlist, or self-referral code is ignored rather than rejected, so a mangled share link never costs you the signup.

The SDK and MCP server bump to 0.3.0 with this release.