QRetro retrospectives and planning poker over MCP: boards, action items, poker games, estimates.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Returns one planning poker game: its estimation scale, progress, the task currently on the table and the link participants use to join. Use poker.game.tasks.list for the tasks themselves.
The ID of the poker game.
Returns one planning poker game: its estimation scale, progress, the task currently on the table and the link participants use to join. Use poker.game.tasks.list for the tasks themselves.
| Argument | Type | Description |
|---|---|---|
| game_id* | string | The ID of the poker game. |
{
"type": "object",
"required": [
"game_id"
],
"properties": {
"game_id": {
"type": "string",
"description": "The ID of the poker game."
}
}
}Reveals the cards of a task and computes its estimate from the votes cast — this is the only way an estimate appears, there is no way to set a number directly. Pass reveal=false to hide the cards again and drop the estimate, which also clears the votes for a re-vote. Only the team owner can change a game. Requires mcp:write scope.
| Argument | Type | Description |
|---|---|---|
| reveal | boolean | true (default) — reveal the cards and compute the estimate. false — hide them, clear the votes and the estimate. |
| game_id* | string | The ID of the poker game. |
| task_id* | string | The ID of the task to reveal. |
{
"type": "object",
"required": [
"game_id",
"task_id"
],
"properties": {
"reveal": {
"type": "boolean",
"description": "true (default) — reveal the cards and compute the estimate. false — hide them, clear the votes and the estimate."
},
"game_id": {
"type": "string",
"description": "The ID of the poker game."
},
"task_id": {
"type": "string",
"description": "The ID of the task to reveal."
}
}
}Puts a task on the table: everyone looking at the game sees it as the one being estimated right now. Only the team owner can change a game. Requires mcp:write scope.
| Argument | Type | Description |
|---|---|---|
| game_id* | string | The ID of the poker game. |
| task_id* | string | The ID of the task to put on the table — see poker.game.tasks.list. |
{
"type": "object",
"required": [
"game_id",
"task_id"
],
"properties": {
"game_id": {
"type": "string",
"description": "The ID of the poker game."
},
"task_id": {
"type": "string",
"description": "The ID of the task to put on the table — see poker.game.tasks.list."
}
}
}Writes the agreed estimate back to the issue tracker — Jira story points, Linear estimate. Works only for tasks imported from a tracker and only when the integration was connected with write permissions; poker.sources.list shows whether it was. Only the team owner can change a game. Requires mcp:write scope.
| Argument | Type | Description |
|---|---|---|
| game_id* | string | The ID of the poker game. |
| task_id* | string | The ID of the task whose estimate goes to the tracker — see needs_sync in poker.game.tasks.list. |
{
"type": "object",
"required": [
"game_id",
"task_id"
],
"properties": {
"game_id": {
"type": "string",
"description": "The ID of the poker game."
},
"task_id": {
"type": "string",
"description": "The ID of the task whose estimate goes to the tracker — see needs_sync in poker.game.tasks.list."
}
}
}Adds tasks to a poker game by hand — for work that lives outside an issue tracker, or when no tracker is connected. To pull tasks from Jira or Linear use poker.game.tasks.import instead. Requires mcp:write scope.
| Argument | Type | Description |
|---|---|---|
| tasks* | array | Tasks to add: a list of objects with name and optional description. |
| game_id* | string | The ID of the poker game. |
{
"type": "object",
"required": [
"game_id",
"tasks"
],
"properties": {
"tasks": {
"type": "array",
"description": "Tasks to add: a list of objects with name and optional description."
},
"game_id": {
"type": "string",
"description": "The ID of the poker game."
}
}
}Pulls tasks from a connected issue tracker into a poker game. Give it either iteration_ref from poker.iterations.list to take a whole sprint, or query to search by text and issue key. Tasks already in the game are skipped. Only the team owner can change a game. Requires mcp:write scope.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many tasks to pull at most. Default: 50, maximum: 100. |
| query | string | Text or issue key to search for, when importing without an iteration. |
| source | string | Tracker to import from, for example jira. Required only when the team has several trackers connected. |
| game_id* | string | The ID of the poker game to import into. |
| iteration_ref | string | The ref of an iteration from poker.iterations.list — imports every task of that sprint. |
{
"type": "object",
"required": [
"game_id"
],
"properties": {
"limit": {
"type": "integer",
"description": "How many tasks to pull at most. Default: 50, maximum: 100."
},
"query": {
"type": "string",
"description": "Text or issue key to search for, when importing without an iteration."
},
"source": {
"type": "string",
"description": "Tracker to import from, for example jira. Required only when the team has several trackers connected."
},
"game_id": {
"type": "string",
"description": "The ID of the poker game to import into."
},
"iteration_ref": {
"type": "string",
"description": "The ref of an iteration from poker.iterations.list — imports every task of that sprint."
}
}
}Returns the tasks of a poker game with their estimate, individual votes, tracker key and link. needs_sync tells whether the agreed estimate still differs from the one stored in the tracker — feed those tasks to poker.game.task.sync. Filter with estimated to see what is done or what is left.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many tasks to return. Default: 50, maximum: 100. |
| game_id* | string | The ID of the poker game. |
| estimated | boolean | true — only tasks that already have an estimate, false — only tasks still to be estimated. Omit for all of them. |
{
"type": "object",
"required": [
"game_id"
],
"properties": {
"limit": {
"type": "integer",
"description": "How many tasks to return. Default: 50, maximum: 100."
},
"game_id": {
"type": "string",
"description": "The ID of the poker game."
},
"estimated": {
"type": "boolean",
"description": "true — only tasks that already have an estimate, false — only tasks still to be estimated. Omit for all of them."
}
}
}Creates a planning poker game for a team and returns the link participants join with. Pick a ready-made scale — fibonacci, modified_fibonacci, tshirts, powers_of_two — or pass your own values in scale_values. Requires mcp:write scope.
| Argument | Type | Description |
|---|---|---|
| name* | string | Name of the game, for example the sprint it plans. |
| scale | string | Estimation scale preset: fibonacci (default), modified_fibonacci, tshirts, powers_of_two. |
| team_id | string | Team the game belongs to. Required when more than one team is available. |
| scale_values | array | Custom scale, for example ["1","2","3","5","?"]. Overrides scale when given. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Name of the game, for example the sprint it plans."
},
"scale": {
"type": "string",
"description": "Estimation scale preset: fibonacci (default), modified_fibonacci, tshirts, powers_of_two."
},
"team_id": {
"type": "string",
"description": "Team the game belongs to. Required when more than one team is available."
},
"scale_values": {
"type": "array",
"description": "Custom scale, for example [\"1\",\"2\",\"3\",\"5\",\"?\"]. Overrides scale when given."
}
}
}Returns the planning poker games of a team, newest first, with how many tasks each of them has and how many already carry an estimate. Personal games outside a team are not exposed over MCP.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many games to return. Default: 20, maximum: 50. |
| team_id | string | Team to list games for. Required when more than one team is available — call retro.teams.list first. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "How many games to return. Default: 20, maximum: 50."
},
"team_id": {
"type": "string",
"description": "Team to list games for. Required when more than one team is available — call retro.teams.list first."
}
}
}Returns the iterations of a connected issue tracker — Jira sprints (active and upcoming), and whatever a future tracker calls the same thing. Filter by name with query, for example "AFT 50". Pass the ref of the iteration you want to poker.game.tasks.import to pull its tasks into a game. Trackers without iteration support (currently Linear) return an empty list — search by text instead.
| Argument | Type | Description |
|---|---|---|
| query | string | Filter iterations by name, for example "AFT 50". Omit to get all active and upcoming ones. |
| source | string | Tracker to query, for example jira. Required only when the team has several trackers connected — see poker.sources.list. |
| team_id | string | Team whose tracker is queried. Required when more than one team is available. |
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Filter iterations by name, for example \"AFT 50\". Omit to get all active and upcoming ones."
},
"source": {
"type": "string",
"description": "Tracker to query, for example jira. Required only when the team has several trackers connected — see poker.sources.list."
},
"team_id": {
"type": "string",
"description": "Team whose tracker is queried. Required when more than one team is available."
}
}
}Returns the issue trackers connected to a team (Jira, Linear) and what each of them can do: search for tasks, list iterations (sprints, cycles), write estimates back. Call this first — the other poker tools depend on what is connected. An empty list means tasks can only be added manually with poker.game.tasks.add.
| Argument | Type | Description |
|---|---|---|
| team_id | string | Team to inspect. Required when more than one team is available — call retro.teams.list first. |
{
"type": "object",
"properties": {
"team_id": {
"type": "string",
"description": "Team to inspect. Required when more than one team is available — call retro.teams.list first."
}
}
}Marks an action item as completed. Requires mcp:write scope.
| Argument | Type | Description |
|---|---|---|
| action_item_id* | string | The ID of the action item to mark as completed. |
{
"type": "object",
"required": [
"action_item_id"
],
"properties": {
"action_item_id": {
"type": "string",
"description": "The ID of the action item to mark as completed."
}
}
}Creates a new action item on a retrospective board. Requires mcp:write scope.
| Argument | Type | Description |
|---|---|---|
| due | string | Due date in ISO 8601 format (e.g. 2025-03-15T00:00:00Z). |
| text* | string | The text of the action item. |
| board_id* | string | The ID of the board to create the action item on. |
| priority | string | Priority: high, medium, or low. Default: medium. |
| assign_to | string | User ID to assign the action item to — call retro.team.members.list to get it — or "me" to assign to the current user. |
{
"type": "object",
"required": [
"board_id",
"text"
],
"properties": {
"due": {
"type": "string",
"description": "Due date in ISO 8601 format (e.g. 2025-03-15T00:00:00Z)."
},
"text": {
"type": "string",
"description": "The text of the action item."
},
"board_id": {
"type": "string",
"description": "The ID of the board to create the action item on."
},
"priority": {
"type": "string",
"description": "Priority: high, medium, or low. Default: medium."
},
"assign_to": {
"type": "string",
"description": "User ID to assign the action item to — call retro.team.members.list to get it — or \"me\" to assign to the current user."
}
}
}Returns action items across all retrospectives at once — the answer to "what did we agree on and never finish". Covers every team available unless team_id narrows it down; filters by status, assignee and date. Use this instead of walking boards one by one with retro.board.actions.list.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many items to return, newest first. Default 50, maximum 200. The total field always reports the full count. |
| since | string | Only items created on or after this date (ISO 8601, for example 2026-01-01). |
| status | string | open (default), completed or all. |
| team_id | string | Narrow the search to one team. By default every available team is included. |
| assignee | string | Filter by assignee name, partial match. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "How many items to return, newest first. Default 50, maximum 200. The total field always reports the full count."
},
"since": {
"type": "string",
"description": "Only items created on or after this date (ISO 8601, for example 2026-01-01)."
},
"status": {
"type": "string",
"description": "open (default), completed or all."
},
"team_id": {
"type": "string",
"description": "Narrow the search to one team. By default every available team is included."
},
"assignee": {
"type": "string",
"description": "Filter by assignee name, partial match."
}
}
}Updates an existing action item: text, priority, due date, or assignee. Requires mcp:write scope.
| Argument | Type | Description |
|---|---|---|
| due | string | New due date in ISO 8601 format. |
| text | string | New text for the action item. |
| priority | string | New priority: high, medium, or low. |
| assign_to | string | User ID to reassign to — call retro.team.members.list to get it — or "me" to assign to the current user. |
| action_item_id* | string | The ID of the action item to update. |
{
"type": "object",
"required": [
"action_item_id"
],
"properties": {
"due": {
"type": "string",
"description": "New due date in ISO 8601 format."
},
"text": {
"type": "string",
"description": "New text for the action item."
},
"priority": {
"type": "string",
"description": "New priority: high, medium, or low."
},
"assign_to": {
"type": "string",
"description": "User ID to reassign to — call retro.team.members.list to get it — or \"me\" to assign to the current user."
},
"action_item_id": {
"type": "string",
"description": "The ID of the action item to update."
}
}
}Returns action items from a retrospective board, including status, priority, assignee, and due date.
| Argument | Type | Description |
|---|---|---|
| board_id* | string | The ID of the board to get action items for. |
| include_completed | boolean | Whether to include completed action items. Default: false. |
{
"type": "object",
"required": [
"board_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "The ID of the board to get action items for."
},
"include_completed": {
"type": "boolean",
"description": "Whether to include completed action items. Default: false."
}
}
}Returns the health check of a retrospective: score per category on a 0-10 scale, alignment between participants, turnout, and the same score across the previous retrospectives of the team. Returns health_check: null when the team did not run a health check on this board.
| Argument | Type | Description |
|---|---|---|
| board_id* | string | The ID of the board to get the health check report for. |
{
"type": "object",
"required": [
"board_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "The ID of the board to get the health check report for."
}
}
}Returns insights (clusters) and suggested actions for a retrospective board. Insights include topic clusters with sentiment, urgency, and category analysis.
| Argument | Type | Description |
|---|---|---|
| board_id* | string | The ID of the board to get insights for. |
{
"type": "object",
"required": [
"board_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "The ID of the board to get insights for."
}
}
}Deletes a single board message. Access is strictly governed by API policies: users can delete their own messages, or any message if they have board update rights (requires mcp:write scope for the latter).
| Argument | Type | Description |
|---|---|---|
| message_id* | string | The ID of the message to delete. |
{
"type": "object",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"description": "The ID of the message to delete."
}
}
}Returns all participant messages (cards) for a retrospective board, organized by template columns (e.g. "What went well", "What didn't go well"). Includes text, sentiment, category, grouping, and vote counts.
| Argument | Type | Description |
|---|---|---|
| board_id* | string | The ID of the board to get messages for. |
{
"type": "object",
"required": [
"board_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "The ID of the board to get messages for."
}
}
}Updates the text of an existing board message created by the current MCP user.
| Argument | Type | Description |
|---|---|---|
| text* | string | New text content for the message. |
| message_id* | string | The ID of the message to update. |
{
"type": "object",
"required": [
"message_id",
"text"
],
"properties": {
"text": {
"type": "string",
"description": "New text content for the message."
},
"message_id": {
"type": "string",
"description": "The ID of the message to update."
}
}
}Returns ROTI (Return on Time Invested) voting metrics for a retrospective board, including average score, distribution, and trend across previous retrospectives.
| Argument | Type | Description |
|---|---|---|
| board_id* | string | The ID of the board to get ROTI metrics for. |
{
"type": "object",
"required": [
"board_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "The ID of the board to get ROTI metrics for."
}
}
}Turns a pending suggested action from retro.board.insights.list into a real action item on the board and marks the suggestion accepted, keeping the wording and the link to its cluster. Requires mcp:write scope.
| Argument | Type | Description |
|---|---|---|
| board_id* | string | The ID of the board the suggestion belongs to. |
| assign_to | string | User ID to assign the action item to — call retro.team.members.list to get it — or "me" to assign to the current user. |
| suggested_action_id* | string | The ID of the suggested action to promote, from suggested_actions in retro.board.insights.list. Only suggestions with status "pending" can be promoted. |
{
"type": "object",
"required": [
"board_id",
"suggested_action_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "The ID of the board the suggestion belongs to."
},
"assign_to": {
"type": "string",
"description": "User ID to assign the action item to — call retro.team.members.list to get it — or \"me\" to assign to the current user."
},
"suggested_action_id": {
"type": "string",
"description": "The ID of the suggested action to promote, from suggested_actions in retro.board.insights.list. Only suggestions with status \"pending\" can be promoted."
}
}
}Rejects a pending suggested action from retro.board.insights.list: the suggestion moves to rejected and no action item is created. Requires mcp:write scope.
| Argument | Type | Description |
|---|---|---|
| board_id* | string | The ID of the board the suggestion belongs to. |
| suggested_action_id* | string | The ID of the suggested action to reject, from suggested_actions in retro.board.insights.list. Only suggestions with status "pending" can be rejected. |
{
"type": "object",
"required": [
"board_id",
"suggested_action_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "The ID of the board the suggestion belongs to."
},
"suggested_action_id": {
"type": "string",
"description": "The ID of the suggested action to reject, from suggested_actions in retro.board.insights.list. Only suggestions with status \"pending\" can be rejected."
}
}
}Returns the summary of a retrospective with participant info and metadata. Works for unfinished boards too — summary is null until the retro is wrapped up, so check is_finished.
| Argument | Type | Description |
|---|---|---|
| board_id* | string | The ID of the board to get the summary for. |
{
"type": "object",
"required": [
"board_id"
],
"properties": {
"board_id": {
"type": "string",
"description": "The ID of the board to get the summary for."
}
}
}Returns retrospectives (boards) of a team, newest first. Unfinished boards are included unless finished_only is set — otherwise check the is_finished flag. Filters by period via since/until. Pass team_id when several teams are available; with a single team it can be omitted.
| Argument | Type | Description |
|---|---|---|
| since | string | Only boards created on or after this date (ISO 8601, for example 2026-01-01). |
| until | string | Only boards created on or before this date (ISO 8601). |
| team_id | string | Team to list boards for. Required when more than one team is available — call retro.teams.list first. |
| finished_only | boolean | Return only finished retrospectives. Default: false, unfinished boards are included. |
{
"type": "object",
"properties": {
"since": {
"type": "string",
"description": "Only boards created on or after this date (ISO 8601, for example 2026-01-01)."
},
"until": {
"type": "string",
"description": "Only boards created on or before this date (ISO 8601)."
},
"team_id": {
"type": "string",
"description": "Team to list boards for. Required when more than one team is available — call retro.teams.list first."
},
"finished_only": {
"type": "boolean",
"description": "Return only finished retrospectives. Default: false, unfinished boards are included."
}
}
}Search across retrospectives by keyword: board summaries, action items and participant cards. Cards hidden by private writing during an ongoing retro are excluded. Optionally filter by team.
| Argument | Type | Description |
|---|---|---|
| query* | string | Search query. Looks into board summaries, action items and participant cards. |
| team_id | string | Optional: filter search to a specific team. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Search query. Looks into board summaries, action items and participant cards."
},
"team_id": {
"type": "string",
"description": "Optional: filter search to a specific team."
}
}
}Returns the members of a team with their id, name and role (owner, admin, facilitator, member). Use the id as assign_to in retro.actions.create, retro.actions.update and retro.board.suggested_actions.promote. This is the team roster, the same one people see in team settings — it says nothing about who wrote which card. Pass team_id when several teams are available; with a single team it can be omitted.
| Argument | Type | Description |
|---|---|---|
| team_id | string | Team to list members for. Required when more than one team is available — call retro.teams.list first. |
{
"type": "object",
"properties": {
"team_id": {
"type": "string",
"description": "Team to list members for. Required when more than one team is available — call retro.teams.list first."
}
}
}Returns the list of teams the user belongs to. boards_count is the total number of boards in a team, finished and unfinished alike — use retro.boards.list to tell them apart.
No arguments.
{
"type": "object",
"properties": {}
}