MCPTool reference
Users
BlueSuite MCP tools for users
See connection and authentication and workflow rules before calling these tools.
Related REST API and behavior.
list_users
List workspace team members. Use this to resolve user names to IDs for assignment operations (e.g., assigning a job to "Bob").
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
page | integer | No | Page number (default: 1) |
per_page | integer | No | Results per page (default: 25) minimum: 1. maximum: 100. |
search | string | No | Search by name, email, phone, or company |
sort_by | "first_name", "last_name", "email", "role", "job_title", "created_at", "updated_at" | No | Field to sort by. There is no "name" field, use first_name or last_name. Unknown values fall back to the default sort. |
sort_direction | "asc", "desc" | No | Sort direction |
Result
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
data | array of object | Yes | The matching records for this page. |
pagination | object | No | How many more pages of results exist. Absent when the API returned an unpaged result. |
pagination.page | integer | When parent supplied | Current page number, 1-based. |
pagination.per_page | integer | When parent supplied | Number of results per page. |
pagination.total_pages | integer | When parent supplied | Total number of pages available. |
The downloadable tool schemas include the full input and output contracts. Tables describe schema-level required fields; cross-field rules still apply.