Waitlister MCP Server

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

What Can You Do With This?

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

• "Add [email protected] to my waitlist"
• "How many subscribers do I have?"
• "Look up the subscriber [email protected]"
• "Update John's points to 500"
• "Show me the top 10 subscribers by referral count"

Tools

| Tool | Description | | --- | --- | | add_subscriber | Add a new subscriber to your waitlist | | list_subscribers | List subscribers with pagination and sorting | | get_subscriber | Get details for a specific subscriber by ID or email | | update_subscriber | Update a subscriber's name, phone, points, or metadata | | log_view | Record a waitlist page view for analytics |

Prerequisites

• Node.js 18+
• A Waitlister account on the Growth or Business plan (API access required)
• Your API key and waitlist key from the Waitlister dashboard

Getting Your Keys

1. Log in to Waitlister
2. Go to Integrations → API access → Generate API key
3. Your waitlist key is found in your waitlist settings

Installation

Using npx (recommended)

No installation needed — just configure your MCP client:

{
  "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:

{
  "mcpServers": {
    "waitlister": {
      "command": "waitlister-mcp",
      "env": {
        "WAITLISTER_API_KEY": "your-api-key",
        "WAITLISTER_WAITLIST_KEY": "your-waitlist-key"
      }
    }
  }
}

Setup by Client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Cursor

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

Claude Code

claude mcp add waitlister -- npx -y waitlister-mcp

Then set the environment variables WAITLISTER_API_KEY and WAITLISTER_WAITLIST_KEY.

Environment Variables

| Variable | Required | Description | | --- | --- | --- | | WAITLISTER_API_KEY | Yes | Your Waitlister API key | | WAITLISTER_WAITLIST_KEY | Yes | Your unique waitlist key |

Tool Reference

add_subscriber

Add a new subscriber to your waitlist.

Parameters:

• email (string, required) — Subscriber's email address
• name (string, optional) — Subscriber's name
• phone (string, optional) — Subscriber's phone number
• referred_by (string, optional) — Referral code of the person who referred them
• metadata (object, optional) — Custom fields (e.g. { "company": "Acme" })

list_subscribers

Retrieve a paginated list of subscribers.

Parameters:

• limit (number, default 20) — Results per page (1–100)
• page (number, default 1) — Page number
• sort_by (string, default "date") — Sort field: position, points, date, referral_count, email
• sort_dir (string, default "desc") — Sort direction: asc or desc

get_subscriber

Get detailed info for a specific subscriber.

Parameters:

• id_or_email (string, required) — Subscriber's ID or email address

update_subscriber

Update a subscriber's information.

Parameters:

• id_or_email (string, required) — Subscriber's ID or email address
• name (string, optional) — Updated name
• phone (string, optional) — Updated phone number
• points (number, optional) — Updated points value
• metadata (object, optional) — Custom fields to add/update (merged with existing)

log_view

Record a waitlist page view.

Parameters:

• visitor_id (string, optional) — Unique visitor identifier (prevents duplicate counts)
• referring_domain (string, optional) — Referring domain

Rate Limits

Rate limits depend on your Waitlister plan:

| Plan | Subscriber Endpoints | Log View Endpoint | | --- | --- | --- | | Growth | 60 requests/min | 200 requests/min | | Business | 120 requests/min | 400 requests/min |

Development

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

Test with the MCP Inspector:

WAITLISTER_API_KEY=your-key WAITLISTER_WAITLIST_KEY=your-key npm run inspect

Links

• Waitlister — Create waitlists for your product launches
• API Documentation
• MCP Protocol

License

MIT