list_pending_invitations

List my pending invitations

List pending invitations matching the actor's verified or unverified emails.

Authorization and permissions

Requires a valid delegated OAuth token and access to the selected workspace.

OAuth scope: mcp:read
Workspace requirement: No workspace required

Authenticated actor only.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "limit": {
      "default": 100,
      "description": "Limit.",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "offset": {
      "default": 0,
      "description": "Offset.",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

Result schema

{
  "additionalProperties": false,
  "properties": {
    "invitations": {
      "description": "Invitations.",
      "items": {
        "additionalProperties": false,
        "description": "Invitations item.",
        "properties": {
          "email": {
            "description": "Email.",
            "format": "email",
            "type": "string"
          },
          "id": {
            "description": "Id.",
            "format": "uuid",
            "type": "string"
          },
          "team_name": {
            "description": "Team name.",
            "type": "string"
          },
          "verified": {
            "description": "Verified.",
            "type": "boolean"
          }
        },
        "required": [
          "id",
          "team_name",
          "email",
          "verified"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "invitations"
  ],
  "type": "object"
}

Example arguments

{
  "limit": 100,
  "offset": 0
}

Example result

{
  "invitations": [
    {
      "email": "[email protected]",
      "id": "0190a7d2-aed8-70bc-a17c-22b629f73a1d",
      "team_name": "Signal Works",
      "verified": true
    }
  ]
}

Errors and retry

Workspace reads require current membership; workspace and invitation administration requires an administrator, while creation requires account-level mcp:teams. Invalid/duplicate slugs or pending emails are rejected; unknown or cross-workspace invitations return not found, and accepted invitations cannot be changed or cancelled. Calls are limited to 120 per user per minute.

Reads are safe to retry. Before retrying workspace or invitation creation after an ambiguous response, list current workspaces or invitations. Updates may be retried after reading current state; never blindly repeat workspace deletion or invitation cancellation.

Effects, limits, and source

Workspace roles, subscription and AI usage limits, approval rules, and server rate limits are enforced at call time. Rate-limit responses identify when to retry; scheduled work returns state rather than holding the request open.

teams.helpers.get_open_invitations_for_user