npm package: @gitleaderboard/mcp-server
Description: Official MCP server for Git Leaderboard rankings, profiles, streaks, and user comparisons.
Latest version: 0.1.8

# @gitleaderboard/mcp-server

Official MCP server for [Git Leaderboard](https://gitleaderboard.dev).

Use it from Claude, Cursor, VS Code, Windsurf, and other MCP-compatible clients to query public GitHub leaderboard data directly from your AI assistant.

## What You Can Ask

- Global rankings by contributions, commits, issues, pull requests, reviews, or impact score
- GitHub user profiles with streaks, achievements, leagues, and global rank
- Username search on Git Leaderboard
- Side-by-side comparison between two GitHub users

## Available Tools

| Tool               | Description                                                                                                                |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| `get_leaderboard`  | Returns global rankings by contributions, commits, issues, PRs, reviews, or impact score. Supports year and month filters. |
| `get_user_profile` | Returns a user's full Git Leaderboard profile, including stats, achievements, streaks, league career, and rank.            |
| `search_users`     | Searches Git Leaderboard users by GitHub username.                                                                         |
| `compare_users`    | Compares two GitHub users side by side across rankings, achievements, and streaks.                                         |

## Quick Start

```bash
npx -y -p @gitleaderboard/mcp-server mcp-server
```

## Client Setup

### Claude Desktop

Add this to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "git-leaderboard": {
      "command": "npx",
      "args": ["-y", "-p", "@gitleaderboard/mcp-server", "mcp-server"]
    }
  }
}
```

### Claude Code

```bash
claude mcp add git-leaderboard -- npx -y -p @gitleaderboard/mcp-server mcp-server
```

### VS Code

Add this to `.vscode/settings.json`:

```json
{
  "mcp": {
    "servers": {
      "git-leaderboard": {
        "command": "npx",
        "args": ["-y", "-p", "@gitleaderboard/mcp-server", "mcp-server"]
      }
    }
  }
}
```

### Cursor

Add this to your MCP settings:

```json
{
  "mcpServers": {
    "git-leaderboard": {
      "command": "npx",
      "args": ["-y", "-p", "@gitleaderboard/mcp-server", "mcp-server"]
    }
  }
}
```

### Windsurf

Add this to your MCP settings:

```json
{
  "mcpServers": {
    "git-leaderboard": {
      "command": "npx",
      "args": ["-y", "-p", "@gitleaderboard/mcp-server", "mcp-server"]
    }
  }
}
```

## Example Prompts

- "Show me the top GitHub contributors by impact score"
- "Who has the most commits this month?"
- "Look up hrvoje0099 on Git Leaderboard"
- "Compare two GitHub users on Git Leaderboard"
- "Search for a GitHub username on Git Leaderboard"

## Configuration

By default, the server queries the production Git Leaderboard backend.

Optional environment variables:

- `CONVEX_URL`: Override the default backend URL

## How It Works

This server uses Git Leaderboard's public backend to expose read-only MCP tools. No API key is required for normal usage.

## Links

- [Git Leaderboard](https://gitleaderboard.dev)
- [Git Leaderboard Repository](https://github.com/hrvoje0099/git-leaderboard)
- [Model Context Protocol](https://modelcontextprotocol.io)

## License

MIT