Member Tools

MCP tools for querying organization members, roles, and invitation status

Query users and their roles within an organization — including contact details, invitation status, and task assignments. Use this to understand team composition and permissions.

list_members

List all members (accepted and pending invitations) of an organization.

Parameters:

Parameter	Type	Required	Default	Description
organization_id	string	No	default org	Organization UUID
page	integer	No	1	Page number
size	integer	No	50	Results per page

Example response:

{
  "items": [
    {
      "id": "c4a5d98e-...",
      "first_name": "María",
      "last_name": "García",
      "email": "[e-mail]",
      "role": "Administrator",
      "role_id": "a1b2c3d4-...",
      "status": "accepted",
      "phone_number": "[phone]",
      "profile_img_url": "https://...",
      "tasks": {
        "total": 12,
        "total_completed": 8
      },
      "created_at": "2024-01-15T10:30:00"
    }
  ],
  "total": 57,
  "page": 1,
  "size": 50,
  "pages": 2
}

Key response fields:

Field	Description
role	Role name — typically Administrator, Manager, or Viewer (custom roles possible)
status	accepted (active member) or pending (invitation sent, not yet accepted)
tasks	Summary of assigned tasks: total and total_completed
profile_img_url	Avatar URL (null if not set)

Example prompts:

"Who are the members of my organization?"
"List all administrators in the team"
"How many users do we have?"
"Show pending invitations"
"Which members have completed all their tasks?"

Workflow

1. List members — list_members to see team composition and roles
2. Check organization — get_organization_metrics for an overview of the organization’s data and activity
3. View facilities — list_facilities to see what sites are managed by the team

Related

Organizations

Organization details and hierarchy

Facilities

Sites managed by the organization’s team

CLI

Manage members from the command line