# MCP: team

Source: <https://telegafirst.com/docs/mcp-team>
Locale: ru
releaseGitSha: c9a428d902de0b479a981e43774f38b9ec077ed7
sourceContentDigest: f480e030a356e441dd659c12b1c6be30f41f16525e03aaa1990e1a23f8bdc20e
Version: 1

# MCP: team

Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required\_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load\_domain/describe\_tool и существующий meta-dispatch описаны в [MCP-руководстве](https://telegafirst.com/docs/mcp-guide). [Scopes и права](https://telegafirst.com/docs/scopes-and-permissions) применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.

## invite\_team\_member

Invite a team member by tg\_username and/or email (≥1 required), with optional permission flags. Creates the member in the `invited` state. OWNER-ONLY. Returns the created member with its `seqNum`.

```json
{
  "description": "Invite a team member by tg_username and/or email (≥1 required), with optional permission flags. Creates the member in the `invited` state. OWNER-ONLY. Returns the created member with its `seqNum`.",
  "domain": "team",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "email": {
        "description": "Value for email.",
        "format": "email",
        "maxLength": 256,
        "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
        "type": "string"
      },
      "permissions": {
        "additionalProperties": false,
        "description": "Value for permissions.",
        "properties": {
          "is_ai_settings_allowed": {
            "description": "Value for is ai settings allowed.",
            "type": "boolean"
          },
          "is_catalog_read_allowed": {
            "description": "Value for is catalog read allowed.",
            "type": "boolean"
          },
          "is_catalog_write_allowed": {
            "description": "Value for is catalog write allowed.",
            "type": "boolean"
          },
          "is_contacts_read_allowed": {
            "description": "Value for is contacts read allowed.",
            "type": "boolean"
          },
          "is_contacts_write_allowed": {
            "description": "Value for is contacts write allowed.",
            "type": "boolean"
          },
          "is_orders_read_allowed": {
            "description": "Value for is orders read allowed.",
            "type": "boolean"
          },
          "is_orders_status_change_allowed": {
            "description": "Value for is orders status change allowed.",
            "type": "boolean"
          },
          "is_orders_write_allowed": {
            "description": "Value for is orders write allowed.",
            "type": "boolean"
          },
          "is_payments_read_allowed": {
            "description": "Value for is payments read allowed.",
            "type": "boolean"
          },
          "is_payments_refund_allowed": {
            "description": "Value for is payments refund allowed.",
            "type": "boolean"
          },
          "is_reports_allowed": {
            "description": "Value for is reports allowed.",
            "type": "boolean"
          },
          "is_settings_access_allowed": {
            "description": "Value for is settings access allowed.",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "tg_username": {
        "description": "Value for tg username.",
        "maxLength": 64,
        "minLength": 1,
        "type": "string"
      }
    },
    "type": "object"
  },
  "name": "invite_team_member",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "team:write"
  ],
  "risk": "write",
  "scope": "team:write",
  "title": "Invite Team Member"
}
```

## list\_team\_members

List the tenant team (operators/members): each with `seqNum` (the id you pass to update/revoke as `seq_num`), tg\_username/email identity, lifecycle status (invited/active/revoked), and the 12 per-capability permission flags. OWNER-ONLY. 0-cost read.

```json
{
  "description": "List the tenant team (operators/members): each with `seqNum` (the id you pass to update/revoke as `seq_num`), tg_username/email identity, lifecycle status (invited/active/revoked), and the 12 per-capability permission flags. OWNER-ONLY. 0-cost read.",
  "domain": "team",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {},
    "type": "object"
  },
  "name": "list_team_members",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "team:read"
  ],
  "risk": "read",
  "scope": "team:read",
  "title": "List Team Members"
}
```

## revoke\_team\_member

Revoke a team member by `seq_num` (sets status=revoked — access is removed but the row is retained for audit). Idempotent (already-revoked → revoked:true). OWNER-ONLY. Errors NOT\_FOUND for a missing tenant sequence.

```json
{
  "description": "Revoke a team member by `seq_num` (sets status=revoked — access is removed but the row is retained for audit). Idempotent (already-revoked → revoked:true). OWNER-ONLY. Errors NOT_FOUND for a missing tenant sequence.",
  "domain": "team",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "seq_num": {
        "description": "Value for seq num.",
        "maximum": 2147483647,
        "minimum": 1,
        "type": "integer"
      }
    },
    "required": [
      "seq_num"
    ],
    "type": "object"
  },
  "name": "revoke_team_member",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "team:write"
  ],
  "risk": "destructive",
  "scope": "team:write",
  "title": "Revoke Team Member"
}
```

## update\_team\_member

Update a team member by `seq_num`: change lifecycle status (invited/active/revoked) and/or the permission flags (partial patch). Identity (tg\_username/email) is IMMUTABLE here. Idempotent. OWNER-ONLY. Errors NOT\_FOUND for a missing tenant sequence.

```json
{
  "description": "Update a team member by `seq_num`: change lifecycle status (invited/active/revoked) and/or the permission flags (partial patch). Identity (tg_username/email) is IMMUTABLE here. Idempotent. OWNER-ONLY. Errors NOT_FOUND for a missing tenant sequence.",
  "domain": "team",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {
      "bot": {
        "description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      },
      "permissions": {
        "additionalProperties": false,
        "description": "Value for permissions.",
        "properties": {
          "is_ai_settings_allowed": {
            "description": "Value for is ai settings allowed.",
            "type": "boolean"
          },
          "is_catalog_read_allowed": {
            "description": "Value for is catalog read allowed.",
            "type": "boolean"
          },
          "is_catalog_write_allowed": {
            "description": "Value for is catalog write allowed.",
            "type": "boolean"
          },
          "is_contacts_read_allowed": {
            "description": "Value for is contacts read allowed.",
            "type": "boolean"
          },
          "is_contacts_write_allowed": {
            "description": "Value for is contacts write allowed.",
            "type": "boolean"
          },
          "is_orders_read_allowed": {
            "description": "Value for is orders read allowed.",
            "type": "boolean"
          },
          "is_orders_status_change_allowed": {
            "description": "Value for is orders status change allowed.",
            "type": "boolean"
          },
          "is_orders_write_allowed": {
            "description": "Value for is orders write allowed.",
            "type": "boolean"
          },
          "is_payments_read_allowed": {
            "description": "Value for is payments read allowed.",
            "type": "boolean"
          },
          "is_payments_refund_allowed": {
            "description": "Value for is payments refund allowed.",
            "type": "boolean"
          },
          "is_reports_allowed": {
            "description": "Value for is reports allowed.",
            "type": "boolean"
          },
          "is_settings_access_allowed": {
            "description": "Value for is settings access allowed.",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "seq_num": {
        "description": "Value for seq num.",
        "maximum": 2147483647,
        "minimum": 1,
        "type": "integer"
      },
      "status": {
        "description": "Value for status.",
        "enum": [
          "invited",
          "active",
          "revoked"
        ],
        "type": "string"
      }
    },
    "required": [
      "seq_num"
    ],
    "type": "object"
  },
  "name": "update_team_member",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "team:write"
  ],
  "risk": "write",
  "scope": "team:write",
  "title": "Update Team Member"
}
```