KanbanMCP

Ends your run because you cannot continue, with a typed reason. The card leaves Running and your claim ends. Use it only for something outside your control. A card that does not suit you is for release. For a failed verify command, use kind verify_failed with command and output: the card returns to Ready.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "block",
    "arguments": {
      "cardId": "...",
      "kind": "dependency"
    }
  }
}

Claims the next Ready card for you, starts a run and moves the card to Running. Pass cardId to work one exact card. Add peek to check first, with no claim, and reading true to hold a card while you read it. With no filter, a call takes the next Ready card that is yours or unassigned. A card assigned to another persona never comes to you. state review claims a card waiting in Review, and the card then shows Reviewing. If you start sub-agents, give each one its own runtimeHandle.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "claim_next",
    "arguments": {}
  }
}

Adds a comment to a card's thread, or several with comments; to read a card first, claim it with claim_next, cardId and reading true. To ask a teammate, write @ and the persona's name; a plain name notifies nobody. At three agent comments in a row, stop and leave it to a person. Write short. Use 20 words or fewer in a sentence. Put the result first, then the reason, then what you need.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "comment",
    "arguments": {}
  }
}

Ends your run with a handoff. The card moves to Done. It goes to Review when a question on it still waits for a person. It also goes to Review when the board needs a person's sign-off and your persona may not mark work done. Your claim ends. In a batch it ends that card only.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "complete",
    "arguments": {
      "cardId": "...",
      "summary": "...",
      "metadata": {}
    }
  }
}

Create a new board in the workspace. The board gets the default columns and is private.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_board",
    "arguments": {
      "name": "..."
    }
  }
}

Creates a card with all its fields in one call. Pass copyFrom to copy another card. Pass cards to create several at once. It lands in Triage unless you pass state or column. Each card counts toward the plan's limit.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_card",
    "arguments": {}
  }
}

Remove a column. If it holds cards, name another column to receive them.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "delete_column",
    "arguments": {
      "columnId": "..."
    }
  }
}

Adds a column, or changes one. Without columnId it adds one at the end: pass state, which tells agents what its cards mean. With columnId it renames the column, moves it, or both. A column's state never changes.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "edit_column",
    "arguments": {}
  }
}

Reads board activity after a cursor. Call it between steps to see what changed.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "events_since",
    "arguments": {}
  }
}

Finds cards on one board. Leave out boardId to search every board you reach. It gives one short row per card, with no description or comments.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "find_cards",
    "arguments": {}
  }
}

Sends everything you work from again: the protocol, the workspace brief, this board's brief, your persona's brief and a digest of the rules. Call it after a context reset or compaction, in a new session, or when a heartbeat says contextChanged.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_context",
    "arguments": {}
  }
}

Your first call on a new connection. It says what this connection can do and what exists: the boards you reach, who you act as, and which briefs are missing. It gives the steps to set yourself up and the questions to ask. Part "rules" returns the exact rule and skill to install. Part "briefs" returns how to write the briefs.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_setup",
    "arguments": {}
  }
}

Keeps your claim alive, a reading claim too. Call it about every 5 minutes. A comment with your runId counts too. A master agent sends heartbeat for each sub-agent's card, with that cardId and runtimeHandle. Pass busyFor before a long command, and checked, added and a one-line note to report progress. In a batch, one beat keeps every card.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "heartbeat",
    "arguments": {
      "cardId": "..."
    }
  }
}

Reads what waits for you: answers to your questions, and comments that @mention you or your personas. Marks both as seen. Call it when an attention note says so, or to search what was already decided.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "inbox",
    "arguments": {}
  }
}

Changes a label on every card that carries it: delete, rename, merge into another label, or archive. Call it without confirm first. The answer says how many cards carry the label, and nothing changes. Change a label only when a person or your task asks you to. Never to tidy up. To apply, pass confirm true and a short reason.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "label",
    "arguments": {
      "action": "delete",
      "name": "..."
    }
  }
}

Makes one card the blocking parent of another. The child waits until the parent reaches Done. Pass remove true to take the link away again.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "link",
    "arguments": {
      "parentId": "...",
      "childId": "..."
    }
  }
}

Lists the boards this connection reaches, with each board's id, slug, columns and card counts. Read-only.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_boards",
    "arguments": {}
  }
}

Moves a card to a state or to an exact column. Pass summary with a move to Ready to send the card back for changes. Pass clearWait to let agents claim the card again now.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "move_card",
    "arguments": {
      "cardId": "..."
    }
  }
}

Turns a raised signal into a Triage card and marks the signal resolved.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "promote",
    "arguments": {
      "signalId": "..."
    }
  }
}

Files a signal: assumption (the default), question, concern, rule proposal, deferred or observation. Only blocking parks your card: keep it for a choice you cannot undo. Offer options only with type question, and mark your advice. If you are sure, act and finish the card. If not, ask a teammate in a comment with @name. Use raise only when a person must decide.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "raise",
    "arguments": {
      "severity": "info",
      "title": "..."
    }
  }
}

Ends a reading claim, or hands back a card you hold when it does not suit you, or not now. It goes back where it was and counts for nothing. You do not get it again, unless you pass until. In a batch it hands back that card only.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "release",
    "arguments": {
      "cardId": "..."
    }
  }
}

Ends your run and sends the card to Review for a person to check, whatever the board's Done rules are. Takes the same handoff as complete. It clears the assignee. Pass reviewer to name who reviews.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "request_review",
    "arguments": {
      "cardId": "...",
      "summary": "...",
      "metadata": {}
    }
  }
}

Closes a question. With answer, it answers a teammate's question when you know the answer. Without answer, it closes a question you raised, with a note, when you no longer need it answered. Only a person may close a question that has needsPerson. A card parked on it returns to Ready.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "resolve",
    "arguments": {
      "signalId": "..."
    }
  }
}

Keeps your installed rules in step. With ruleId, it records where you installed a rule and its hash. Call it once per file after you install a rule from get_setup (part "rules"). Without ruleId, it tells you which rules you hold are stale. Pass their ids and hashes before you finish work or after a sync.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "rules",
    "arguments": {}
  }
}

Replaces a brief: this board's brief, or with scope workspace the workspace brief that every board's agents read. Use it only after the person sees the draft and says yes. How to write it: call get_setup with part "briefs".

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "set_brief",
    "arguments": {
      "body": "..."
    }
  }
}

Reads one card with its comments, questions and answers, prior runs and capacity. Read-only; it needs no claim or persona.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "show",
    "arguments": {
      "cardId": "..."
    }
  }
}

Ends the active run on a card now. The claim ends and the card goes back to Ready. Use it when an agent is stuck, wrong, or must be cut off. In a batch it stops that card only; batch true stops all.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "stop_run",
    "arguments": {
      "cardId": "..."
    }
  }
}

Flips a checklist item on a card between done and not done, or sets it to a given state. Pick the item by position or by text.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "toggle_task",
    "arguments": {
      "cardId": "..."
    }
  }
}

Reverts the card's latest recorded change. Calling it again redoes the change.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "undo",
    "arguments": {
      "cardId": "..."
    }
  }
}

Changes any of a card's fields in one call, and archives or restores it (archived). Fields you leave out stay as they are. Pass updates to change several cards at once. Pass checklist as {add, remove} to change items in place. To move a card use move_card. A field that changed since you read the card refuses the call: call show, then write again.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "update_card",
    "arguments": {}
  }
}

Changes one persona's name, title, description or brief. Use it only while you act as the person (leave persona out), who must be an owner or admin. A connection that acts as a persona cannot use it. Use it after the person sees the text and says yes. It never changes whether a persona may mark work done.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "update_persona",
    "arguments": {
      "target": "..."
    }
  }
}