> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shipstar.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# list_mailing_lists

> List the project's mailing lists for release notes emails

Lists the project's mailing lists for release notes emails — each list's `id`, `name`, and active recipient count. Lists and recipients are managed in the Shipstar dashboard under Destinations → Email. No arguments.

## Returns

```json theme={null}
[
  { "id": "9c1f7e55-...", "name": "Customers", "active_recipients": 312 },
  { "id": "b40d2a88-...", "name": "Beta testers", "active_recipients": 47 }
]
```

Pass one or more `id` values to [`send_release_email`](/mcp/email/send-release-email) to deliver a completed release notes email. `active_recipients` counts only subscribed (non-unsubscribed) addresses.

## Example prompts

> "What mailing lists do we have, and how many people are on each?"

> "Send the release email to whichever list has our beta testers."
