@tickr/mcp-server

MCP (Model Context Protocol) server for Tickr project management.

Quick Start

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "tickr": {
      "command": "npx",
      "args": ["-y", "@tickr/mcp-server"],
      "env": {
        "TICKR_API_URL": "https://your-tickr-instance.com",
        "TICKR_API_KEY": "tk_your_api_key"
      }
    }
  }
}

Claude Code

claude mcp add tickr -- npx -y @tickr/mcp-server

Set environment variables:

export TICKR_API_URL=https://your-tickr-instance.com
export TICKR_API_KEY=tk_your_api_key

Configuration

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | TICKR_API_URL | Yes | https://localhost:6001 | Tickr API base URL | | TICKR_API_KEY | Yes | — | API key (tk_...) from Tickr admin | | TICKR_DEFAULT_PROJECT | No | — | Default project slug |

Or use config file ~/.tickr/config.json:

{
  "apiUrl": "https://your-tickr-instance.com",
  "apiKey": "tk_your_api_key",
  "defaultProject": "my-project"
}

Available Tools (17)

| Tool | Description | |------|-------------| | create_ticket | Create a new ticket | | list_tickets | List tickets with filters | | get_ticket | Get ticket detail by number | | update_ticket | Update ticket fields | | search_tickets | Fulltext search | | add_comment | Add comment to ticket | | update_implementation_item | Update implementation table row | | triage_list | List untriaged tickets | | triage_accept | Accept triaged ticket | | triage_reject | Reject triaged ticket | | list_labels | List project labels | | add_label | Add label to ticket | | remove_label | Remove label from ticket | | list_cycles | List project cycles | | assign_cycle | Assign ticket to cycle | | list_epics | List project epics | | assign_epic | Assign ticket to epic |

Resources (2)

| URI | Description | |-----|-------------| | tickr://ticket/{number} | Ticket detail as markdown | | tickr://project/{slug} | Project overview + recent tickets |

License

MIT