# Fizzy MCP Server & Antigravity Ticket Resolver

Integrate [Fizzy](https://fizzy.do) 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`:
```env
FIZZY_TOKEN=your_personal_access_token_here
```

### 2. Install Dependencies
```bash
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):

```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`:
```bash
./.venv/bin/pytest
```