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

# Member Tools

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

# Member Tools

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:**

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "items": [
    {
      "id": "c4a5d98e-...",
      "first_name": "María",
      "last_name": "García",
      "email": "maria@company.com",
      "role": "Administrator",
      "role_id": "a1b2c3d4-...",
      "status": "accepted",
      "phone_number": "+34612345678",
      "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

<CardGroup cols={2}>
  <Card title="Organizations" icon="building" href="/mcp/organizations">
    Organization details and hierarchy
  </Card>

  <Card title="Facilities" icon="map-pin" href="/mcp/facilities">
    Sites managed by the organization's team
  </Card>

  <Card title="CLI" icon="terminal" href="/cli/members">
    Manage members from the command line
  </Card>
</CardGroup>