list_contacts

List contacts in the workspace, optionally searched (email + name) or filtered by plan. Sort by created, last_seen, or mrr. Cursor pagination.

required scope: read.

example prompts

• “show me my top-MRR contacts on the Pro plan.”
• “find every contact whose email starts with ‘acme’.”
• “list the 20 most recently seen customers.”

input

field	type	required	notes
q	string (max 200 chars)	no	Search email + name (ILIKE).
sort	enum (created, last_seen, mrr)	no	Default: created.
plan	string[] (min 1)	no	Exact-match plan filter, e.g. [“pro”,“team”].
cursor	string	no
limit	integer (1-100)	no

notes

• The plan filter accepts a single value or an array; matches are exact (case-sensitive).
• mrr sort places contacts with null mrr at the end of the result set (NULLS LAST).

output

{ "data": [Contact, ...], "nextCursor": "..." | null }.