waitlister-mcp

Serveur MCP pour l'API Waitlister. Gérez vos abonnés à la liste d'attente, suivez les inscriptions et enregistrez les vues via des assistants IA comme Claude, Cursor et Windsurf.

GitHub

Documentation

Waitlister MCP Server — `@waitlister/mcp`

An MCP (Model Context Protocol) server that connects AI assistants like Claude, Cursor, and Windsurf to the Waitlister API. Create waitlists and manage subscribers through natural language.

This is the official package, superseding waitlister-mcp (1.0.x). Existing waitlister-mcp configurations keep working, but new setups should use @waitlister/mcp — it adds account-key support, waitlist creation, stats, and deletion, and works on every plan.

What Can You Do With This?

Once connected, you can ask your AI assistant things like:

"Create a waitlist for my new product and give me the signup form URL"
"Add test@gmail.com to my waitlist"
"How many subscribers do I have?"
"Look up the subscriber john@acme.com"
"Update John's points to 500"
"Show me the top 10 subscribers by referral count"

Tools

Tool	Description	Plan
`create_waitlist`	Create a new waitlist; returns its key + a form URL that collects signups immediately	Every plan (account key)
`list_waitlists`	List every waitlist you own, with subscriber/view counts	Every plan (account key)
`get_stats`	Subscriber + view counters for a waitlist (cheap social proof)	Every plan
`add_subscriber`	Add a new subscriber to a waitlist	Every plan
`list_subscribers`	List subscribers with pagination and sorting	Growth+
`get_subscriber`	Get details for a specific subscriber by ID or email	Growth+
`update_subscriber`	Update a subscriber's name, phone, points, or metadata	Growth+
`delete_subscriber`	Permanently delete a subscriber (irreversible)	Growth+
`log_view`	Record a waitlist page view for analytics	Every plan

Prerequisites

Node.js 18+
A Waitlister account — the free plan works
An account API key (recommended), or a per-waitlist API key (Growth plan+)

Getting Your Key

Account key (recommended — works on every plan, covers every waitlist you own):

Log in to Waitlister
Go to Settings → API keys → create a key (wl_acct_…)

Per-waitlist key (legacy, Growth plan+): waitlist → Integrations → API access. You'll also need the waitlist key from the waitlist's settings.

Installation

Using npx (recommended)

No installation needed — just configure your MCP client:

{
  "mcpServers": {
    "waitlister": {
      "command": "npx",
      "args": ["-y", "@waitlister/mcp"],
      "env": {
        "WAITLISTER_ACCOUNT_KEY": "wl_acct_your-key"
      }
    }
  }
}

With an account key you can optionally add "WAITLISTER_WAITLIST_KEY": "your-waitlist-key" to set a default waitlist — otherwise each tool call can target any waitlist you own via its waitlist_key parameter (ask the assistant to run list_waitlists first).

Legacy per-waitlist configuration (still supported)

{
  "mcpServers": {
    "waitlister": {
      "command": "npx",
      "args": ["-y", "@waitlister/mcp"],
      "env": {
        "WAITLISTER_API_KEY": "your-api-key",
        "WAITLISTER_WAITLIST_KEY": "your-waitlist-key"
      }
    }
  }
}

Global install

npm install -g @waitlister/mcp

Then configure with "command": "waitlister-mcp" and the same env.

Setup by Client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows) with the JSON above.

Cursor

Go to Settings → MCP → Add new MCP server and use the same configuration.

Claude Code

claude mcp add waitlister --env WAITLISTER_ACCOUNT_KEY=wl_acct_your-key -- npx -y @waitlister/mcp

Environment Variables

Variable	Required	Description
`WAITLISTER_ACCOUNT_KEY`	One of the two keys	Account API key (`wl_acct_…`, Settings → API keys). Every plan; every waitlist you own; unlocks `create_waitlist`/`list_waitlists`.
`WAITLISTER_API_KEY`	One of the two keys	Per-waitlist API key (Growth+). Requires `WAITLISTER_WAITLIST_KEY`.
`WAITLISTER_WAITLIST_KEY`	With `WAITLISTER_API_KEY`; optional otherwise	Default waitlist for the waitlist-scoped tools.

Notes

Uniqueness: waitlist names and URL slugs are unique across all of Waitlister. create_waitlist rejects a taken name/slug with a message telling you what to change.
Async counters: signups and deletions update get_stats counters and queue positions within a few seconds, not instantly.
Plan gating: creating waitlists, adding subscribers, and stats work on every plan (lower rate limits on free plans). Reading/updating/deleting subscriber data requires Growth or higher — see rate limits.
Built on the official waitlister SDK (typed errors, automatic retries with backoff).

Development

git clone https://github.com/ilpr/waitlister-mcp.git
cd waitlister-mcp
npm install
npm run build

Test with the MCP Inspector:

WAITLISTER_ACCOUNT_KEY=wl_acct_your-key npm run inspect

License

MIT