Produckt MCP Server

Connect AI assistants to your Produckt boards via Model Context Protocol (MCP).

Read board data, create cards, manage sprints, and analyze dependencies — all from Claude Desktop, Cursor, VS Code, or any MCP-compatible AI tool.

Setup

1. Get Your API Token

Log in to get a JWT token:

curl -s http://localhost:3001/api/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","password":"yourpassword"}' \
  | jq -r '.data.token'

2. Build the Server

cd mcp-server
npm install
npm run build

3. Configure Your AI Tool

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "produckt": {
      "command": "node",
      "args": ["/path/to/produckt/mcp-server/dist/index.js"],
      "env": {
        "PRODUCKT_API_URL": "http://localhost:3001/api",
        "PRODUCKT_API_TOKEN": "your-jwt-token"
      }
    }
  }
}

Cursor / VS Code (Claude Code)

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "produckt": {
      "command": "node",
      "args": ["./mcp-server/dist/index.js"],
      "env": {
        "PRODUCKT_API_URL": "http://localhost:3001/api",
        "PRODUCKT_API_TOKEN": "your-jwt-token"
      }
    }
  }
}

Available Tools (19)

Read Operations

| Tool | Description | |------|-------------| | list_projects | List all projects you have access to | | list_boards | List boards in a project | | get_board_overview | Full board picture: hierarchy, cards, connections, properties | | list_cards | List cards with optional level/parent filtering | | get_card | Detailed single card with properties and connections | | search | Search across cards, boards, and projects |

Write Operations

| Tool | Description | |------|-------------| | create_card | Create a new card on a board | | update_card | Update card title, content, dates, or parent | | delete_card | Delete a card and its descendants | | set_card_properties | Set status, story points, or any property | | create_connection | Connect two cards (link or blocker) | | delete_connection | Remove a connection |

Sprint Management

| Tool | Description | |------|-------------| | list_sprints | List sprints (optionally filter by status) | | get_sprint_details | Sprint metrics, health score, and progress | | add_cards_to_sprint | Add cards to a sprint | | remove_cards_from_sprint | Remove cards from a sprint |

Intelligence

| Tool | Description | |------|-------------| | get_dependency_graph | Board-wide dependency analysis with critical path | | get_blocker_chain | Trace upstream/downstream blockers for a card | | add_comment | Add a comment to a card |

Example Conversations

"What's on my board?"

The AI calls list_projects → list_boards → get_board_overview to give you a full picture.

"Create a card for user authentication under the Auth module"

The AI calls get_board_overview to find the Auth module's card ID and level, then create_card with the right parentCardId and levelId.

"What's blocking the release?"

The AI calls get_dependency_graph to identify the critical path and bottleneck cards.

"Move PROJ-42 to In Progress"

The AI calls search to find the card, get_board_overview to find the status property and "In Progress" option ID, then set_card_properties.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | PRODUCKT_API_URL | No | http://localhost:3001/api | Produckt API base URL | | PRODUCKT_API_TOKEN | Yes | — | JWT token from login |

Development

npm run dev    # Watch mode with tsx
npm run build  # Compile TypeScript
npm start      # Run compiled server