create_invitation

Invite users to projects or organizations by email, assign roles, and include custom messages for collaboration setup.

Instructions

Invite users to project or organization by email

Args: scope_type: Whether to invite users to organization or project scope_name: Name of the organization or project to invite users to role: Role to assign to invited users emails: List of email addresses to invite extra_invitation_text: Custom message to include in the invitation

Input Schema

TableJSON Schema

Name	Required	Description	Default
`scope_type`	Yes
`scope_name`	Yes
`role`	Yes
`emails`	Yes
`extra_invitation_text`	No

Implementation Reference

src/waldur_mcp_server/server.py:97-149 (handler)

Handler function for the 'create_invitation' tool, decorated with @mcp.tool() for registration. It resolves roles, scopes (customer/project), and creates invitations using the Waldur API client.

@mcp.tool()
async def create_invitation(
    scope_type: Literal["customer", "project"],
    scope_name: str,
    role: str,
    emails: list[str],
    extra_invitation_text: str = "",
) -> list[Invitation]:
    """Invite users to project or organization by email

    Args:
        scope_type: Whether to invite users to organization or project
        scope_name: Name of the organization or project to invite users to
        role: Role to assign to invited users
        emails: List of email addresses to invite
        extra_invitation_text: Custom message to include in the invitation
    """

    matching_roles = await roles_list.asyncio(client=client, description=role)
    if not matching_roles:
        raise ValueError(f"Role '{role}' not found")
    role_uuid = matching_roles[0]["uuid"]

    if scope_type == "customer":
        matching_customers = await customers_list.asyncio(
            client=client, name=scope_name
        )
        if not matching_customers:
            raise ValueError(f"Customer '{scope_name}' not found")
        scope_url = matching_customers[0]["url"]
    elif scope_type == "project":
        matching_projects = await projects_list.asyncio(client=client, name=scope_name)
        if not matching_projects:
            raise ValueError(f"Project '{scope_name}' not found")
        scope_url = matching_projects[0]["url"]

    if not scope_url:
        raise ValueError(f"Invalid scope type: {scope_type}")

    results = []
    for email in emails:
        result = await user_invitations_create.asyncio(
            client=client,
            body=InvitationRequest(
                scope=scope_url,
                role=role_uuid,
                email=email,
                extra_invitation_text=extra_invitation_text,
            ),
        )
        results.append(result)

    return results

Waldur MCP Server