@bragduck/mcp

MCP (Model Context Protocol) server that lets AI agents log career achievements to BragDuck.

Works with any MCP-compatible client: Claude Code, Cursor, Windsurf, and others.

Setup

Claude Code

claude mcp add bragduck -- npx @bragduck/mcp@latest

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bragduck": {
      "command": "npx",
      "args": ["@bragduck/mcp@latest"]
    }
  }
}

VS Code (Copilot)

Add to your VS Code settings JSON:

{
  "mcp": {
    "servers": {
      "bragduck": {
        "command": "npx",
        "args": ["@bragduck/mcp@latest"]
      }
    }
  }
}

Authentication

On first use, call the login tool. This opens your browser for OAuth authentication with BragDuck. Credentials are stored locally in ~/.bragduck/credentials.enc (encrypted, shared with the BragDuck CLI).

Tools

login

Authenticate with BragDuck via browser-based OAuth.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | force | boolean | No | Force re-authentication even if already logged in |

log_brag

Log a career achievement to BragDuck.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | title | string | Yes | Short title (10-200 characters) | | description | string | Yes | Detailed description of what was accomplished (50-2000 characters) | | type | string | Yes | Category: progress, achievement, recognition, support, code, leadership, learning, collaboration, challenge, innovation, meeting, bug, others | | impact_level | number | Yes | 0 = none, 1 = low (individual), 2 = medium (team), 3 = high (organization) | | impact_description | string | Yes | Narrative with scope and measurable outcomes | | tags | string[] | No | Tags to categorize the brag | | date | string | No | ISO datetime (defaults to now) | | orgId | string | No | Organisation ID to associate with |

list_brags

List recent brags with optional filtering.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | limit | number | No | Number of brags to return (default: 10, max: 50) | | search | string | No | Search by title or description | | tags | string[] | No | Filter by tags |

list_objectives

List your OKRs (Objectives and Key Results). Returns goal IDs that can be used with link_brag_to_goal.

No parameters required.

link_brag_to_goal

Link a brag to a goal/key-result.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | bragId | string | Yes | The brag ID | | goalId | string | Yes | The goal ID |

Requirements

• Node.js >= 20.0.0
• A BragDuck account

License

MIT