fizzy-mcp

Create or update a card with full control over status, tags, steps, and column placement.

Mode detection:

• card_number absent → CREATE mode (requires board_id + title)

• card_number present → UPDATE mode

Create mode: Creates card, then best-effort: adds steps, toggles tags, triages to column.

Update mode: Updates title/description if provided. Changes status (open/closed/not_now). Manages tags with add/remove. Moves card to column (from inbox or another column). Same-column moves are skipped.

Fizzy column conventions:

• Maybe? (inbox): Cards with no column_id. This is where new cards start.

• Not Now: Set status: "not_now" to move here (defers the card).

• Done: Set status: "closed" to move here (completes the card).

• Custom columns: Use column_id from fizzy_boards to triage to workflow columns.

Arguments:

• account_slug (optional): Uses session default if omitted

• card_number (optional): Card to update. Omit to create new card.

• board_id (optional): Board ID. Required for create mode.

• title (optional): Card title. Required for create mode.

• description (optional): Card body in markdown

• status (optional): open | closed | not_now — changes card lifecycle state

• column_id (optional): Move card to this column (works from inbox or other columns; skipped if already there)

• position (optional): top | bottom (default: bottom) — position in column

• add_tags (optional): Tag titles to add

• remove_tags (optional): Tag titles to remove

• steps (optional): Checklist items to create (create mode only)

Returns: JSON with mode, card (id, number, title, url, status), operations summary, failures array.

Examples: Create: {board_id: "...", title: "New task", steps: ["Step 1", "Step 2"]} Update: {card_number: 42, status: "closed", add_tags: ["done"]}