invite_user
Destructive
Invite someone to your Marcora account by email. An invitation email is sent automatically, and the response also returns the exact invite link (invite_link) so you can share it directly — e.g. paste it to the person in Slack.
Roles:
- "creator" — a full team member who can create and edit content.
- "admin" — a team administrator.
- "collaborator" — a project-scoped collaborator who only works inside a specific project.
Who can invite whom:
- You must be an ADMIN to invite someone as an "admin" or a "creator". Admins can invite any role.
- A "creator" can invite "collaborator"s only.
- Viewers cannot invite anyone.
project_id (a project UUID from list_projects):
- REQUIRED when role is "collaborator" — it is the project they will collaborate on.
- OPTIONAL for "creator" and "admin". It does NOT limit their access (creators and admins keep full team access); it simply also adds them to that project and makes their invite link drop them straight into it on first sign-in.
The invitee is emailed automatically: brand-new users get a sign-up link (returned in invite_link); existing users who still belong to an active team get a login link and will see the invitation in-app after they log in; existing users with no active team (e.g. a removed teammate) get a sign-up link to rejoin with their existing password. The call fails if the email is already an active team member (with no project to add them to), already has a pending invitation, or if you lack permission for the requested role.Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"email": "<email>",
"role": "<role>"
},
"name": "invite_user"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | Yes | Role to grant: admin, creator, or collaborator | |
| Yes | Email address of the person to invite | ||
| project_id | No | Project UUID (from list_projects). Required for collaborator; for creator/admin, optionally also adds them to this project and deep-links their invite to it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | Yes | admin | creator | collaborator | |
| Yes | |||
| emailed | Yes | True when an invitation email was sent to the invitee | |
| message | Yes | Human-readable summary of what happened | |
| outcome | Yes | invited = an invitation email was sent; added_to_project = the email was already a team member and was added straight to the project | |
| project_id | No | Project the invitee was added to / pointed at, if any | |
| invite_link | No | The exact link to share directly. For new users this is the sign-up link (with the project deep-link when a project was given); for existing users it is the login URL. Null when no invitation was sent (added_to_project). | |
| invite_token | No | Invitation token, when an invitation was sent | |
| existing_user | No | True if the email already had a Marcora account (login link) vs a new sign-up link | |
| invitation_id | No | ID of the created/reused team_invitation, when an invitation was sent |