Fizzy MCP Server & Antigravity Ticket Resolver

Integrate Fizzy with Antigravity (and other Model Context Protocol clients) for automated ticket resolution, card management, commenting, and task tracking.

Features

• 🔑 Authentication: Authenticate using standard Fizzy Personal Access Tokens (PAT).
• 🏷️ Card Management: Fetch, search, create, update, close, and reopen cards/tickets.
• 💬 Rich Commenting: List comments and post Markdown resolution comments automatically.
• 🎯 High-level fizzy_resolve_ticket tool: Formats a detailed resolution summary, attaches it to the card on Fizzy, and marks the card as closed/done in a single step.
• 🧠 Antigravity Skill (fizzy-resolver): Teaches Antigravity how to read Fizzy ticket specs, modify codebase files, run verification tests, and resolve tickets automatically.

---

Setup & Configuration

1. Environment Setup

Add your Fizzy PAT token to .env:

FIZZY_TOKEN=your_personal_access_token_here

2. Install Dependencies

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. MCP Configuration

The project includes preconfigured MCP settings in [.vscode/mcp.json](file:///home/kd/Work/fizzy-mcp/.vscode/mcp.json):

{
  "mcpServers": {
    "fizzy": {
      "command": "/home/kd/Work/fizzy-mcp/.venv/bin/python",
      "args": ["-m", "src.server"],
      "cwd": "/home/kd/Work/fizzy-mcp"
    }
  }
}

---

MCP Tools Provided

Tool	Description
fizzy_get_identity	Get authenticated user info and accounts list
fizzy_list_boards	List available Fizzy boards
fizzy_list_cards	Filter/search cards (by board, status, query terms)
fizzy_get_card	Get ticket details and acceptance criteria by ID or card number
fizzy_create_card	Create a new ticket card
fizzy_update_card	Update title, description, or column of a card
fizzy_list_comments	Read discussion comments on a card
fizzy_add_comment	Post a comment to a card
fizzy_close_card	Close a card/ticket
fizzy_reopen_card	Reopen a closed card
fizzy_resolve_ticket	Post resolution summary & close ticket in one tool call

---

Testing

Run tests with pytest:

./.venv/bin/pytest