Back to Home

AI Skills Integration

Connect MyBrag to Claude, Cursor, and other AI assistants to log your accomplishments hands-free.

How It Works
1

Generate API Token

Go to Settings and generate your personal API token

2

Configure Your AI

Add the token to Claude, Cursor or use the API directly

3

Log Accomplishments

Ask your AI to log work wins using the STAR method

Security Note

Your API token grants access to create entries in your account. Keep it secret and never share it publicly. Session tokens expire after 3 hours for added security.

Quick Setup (Recommended)
Run this command to automatically configure Claude Desktop and/or Cursor
curl -fsSL https://www.mybrag.app/setup-mcp.sh | bash

This script will:

  • Detect if you have Claude Desktop and/or Cursor installed
  • Automatically add MyBrag MCP configuration
  • Preserve your existing MCP configurations

Works on macOS, Linux, and Windows (with Git Bash/WSL). View script source

Manual Configuration
Alternatively, manually add MyBrag to Claude Desktop or Cursor

Add the matching configuration for your AI assistant:

Cursor: ~/.cursor/mcp.json

{
  "mcpServers": {
    "mybrag": {
      "type": "http",
      "url": "https://www.mybrag.app/api/mcp/mcp"
    }
  }
}

Claude Desktop: claude_desktop_config.json

{
  "mcpServers": {
    "mybrag": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.mybrag.app/api/mcp/mcp"]
    }
  }
}

Available Tools

mybrag_verify_token

Verify your API token and check authentication status.

mybrag_add_entry

Add a new career entry using the STAR method. Requires title and at least one STAR field.

Usage Example

Just tell Claude or Cursor: "Log my accomplishment: I shipped the new authentication system today. The old system had security vulnerabilities (situation), I was tasked to rebuild it (task), I implemented OAuth2 with MFA (action), and we now have zero security incidents (result)."

REST API
Direct API access for any integration

Authentication Flow

  1. Exchange your API token for a session token (valid 3 hours)
  2. Use the session token as Bearer auth for API requests
  3. Create entries using the STAR method format

Example Usage

# 1. Get a session token (valid for 3 hours)
curl -X POST https://www.mybrag.app/api/auth-ai \
  -H "Content-Type: application/json" \
  -d '{"apiToken": "YOUR_API_TOKEN"}'

# Response: { "token": "eyJ...", "expiresAt": "..." }

# 2. Create an entry using the session token
curl -X POST https://www.mybrag.app/api/entries \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -d '{
    "title": "Shipped new feature",
    "situation": "Our dashboard lacked real-time updates",
    "task": "Implement WebSocket connections for live data",
    "action": "Built a WebSocket service with reconnection logic",
    "result": "Reduced data latency from 30s to <1s",
    "entry_date": "2024-01-15"
  }'

Entry Fields (STAR Method)

titleRequired. Brief description of the accomplishment.
situationContext or background of the situation.
taskYour responsibility or goal.
actionWhat you did specifically.
resultThe outcome or impact.
entry_dateOptional. YYYY-MM-DD format. Defaults to today.
Claude Custom Instructions
Add these instructions to Claude to enable accomplishment logging
When I ask you to log my work accomplishments, use the MyBrag API to create entries.

Each entry should follow the STAR method:
- Situation: What was the context or background?
- Task: What was your responsibility or goal?
- Action: What did you do specifically?
- Result: What was the outcome or impact?

API Endpoint: POST https://www.mybrag.app/api/entries
Authorization: Bearer <session_token>

To get a session token, first call:
POST https://www.mybrag.app/api/auth-ai
Body: { "apiToken": "YOUR_API_TOKEN" }

Then use the returned token for entry creation.

Ready to get started?

Generate your API token in Settings