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:

{
  "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

Fizzy MCP Server