MCP tool reference
Teams
MCP tools for teams.
Generated from the live tool catalog in packages/mcp/src/server.ts. Run pnpm mcp-docs in apps/docs to regenerate after changing a tool.
list_teams
List all teams in the workspace, including their workflow states and settings.
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
create_team
Create a team. Admin only.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | Team name |
key | string | yes | Short team key, 1-8 alphanumeric chars starting with a letter, e.g. VOID |
cyclesEnabled | boolean | no | Whether the team uses cycles |
cycleLengthWeeks | integer | no | Default cycle length |
estimateScale | "none" | "fibonacci" | "linear" | "tshirt" | no | Issue estimate scale |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
update_team
Update a team's settings. Only provided fields change.
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | yes | Team key |
name | string | no | Team name |
cyclesEnabled | boolean | no | Whether the team uses cycles |
cycleLengthWeeks | integer | no | Default cycle length |
estimateScale | "none" | "fibonacci" | "linear" | "tshirt" | no | Issue estimate scale |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
delete_team
Delete a team. Admin only. Personal spaces cannot be deleted.
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | yes | Team key |
deleteProjects | boolean | no | Also delete projects that belong solely to this team |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
join_team
Join a shared team as the API key owner (admin governance). Admin only.
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | yes | Team key |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
list_all_teams
List every shared team in the workspace, joined or not, for governance. Admin only.
| Parameter | Type | Required | Description |
|---|---|---|---|
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
list_team_members
List a team's members plus the wider workspace member list for context.
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | yes | Team key |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
add_team_member
Add a workspace member to a team.
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | yes | Team key |
userId | string | yes | User id to add |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
remove_team_member
Remove a member from a team.
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | yes | Team key |
userId | string | yes | User id to remove |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
list_team_workflows
List a team's PR-trigger workflow rules, workflow states, and linked projects.
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | yes | Team key |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
upsert_team_workflow
Create or replace a team's PR-trigger rule (upsert on team, trigger, project).
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | yes | Team key |
trigger | "pr_opened" | "pr_draft" | "pr_ready" | "pr_reopened" | "pr_merged" | "pr_closed" | yes | PR event that fires the rule |
targetStateId | string | yes | Workflow state id to move the issue to |
projectId | unknown | no | Restrict the rule to this project, or null for all |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |
delete_team_workflow
Delete a team's PR-trigger rule.
| Parameter | Type | Required | Description |
|---|---|---|---|
key | string | yes | Team key |
id | string | yes | Workflow rule id |
workspace | string | no | Workspace slug, name, or id. Only needed with an account-scoped token that reaches more than one workspace; defaults to the connection's active workspace. |