Tool reference · Account metadata
list_users EngageBay MCP tool
Get the id, name, email, and role for everyone on the account — the step that turns a person's name into the owner id a filter actually needs.
- Category
- Account metadata
- Permission needed
account.users.read- Access type
- Read-only
- Works with
search_crm_objectscount_crm_objects
On this page
What this tool does
Records in EngageBay — deals, tasks, and so on — store their owner as an internal user id, not as a name. When a request mentions a person by name (“tasks assigned to Priya”), that name needs to be resolved to the matching id before it can be used in a filter, because filters match ids, never names.
list_users returns everyone on the account with their id, name, email, and role, in a single call. It takes no parameters — it always returns the full list, which your assistant then matches against the name in your request.
This is a small, whole-account list. There's no search or filter parameter here, because account user lists are typically small enough that returning everyone in one call is simpler than paging through it.
What you can ask
“How many tasks are overdue for Priya?” — list_users resolves “Priya” to an id, then count_crm_objects filters on it.
“Who are all the users on this account?”
“What's Priya's role on the account?”
“Show me deals owned by Raj.”
Related tools
search_crm_objectsandcount_crm_objects— use the id fromlist_usersin any owner-based filter.
More tools
Use list_users from your AI tool
Connect your AI tool to the EngageBay MCP server and ask in plain language — it calls the right tool for you.
