Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@bragduck/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@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