@gitleaderboard/mcp-server

@gitleaderboard/mcp-server

Official MCP server for Git Leaderboard.

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

Run the server through npx:

npx -y @gitleaderboard/mcp-server

The package exposes the CLI entrypoint mcp-git-leaderboard, but in most MCP clients npx -y @gitleaderboard/mcp-server is the simplest setup.

Client Setup

Claude Desktop

Add this to claude_desktop_config.json:

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

Claude Code

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

VS Code

Add this to .vscode/settings.json:

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

Cursor

Add this to your MCP settings:

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

Windsurf

Add this to your MCP settings:

{
  "mcpServers": {
    "git-leaderboard": {
      "command": "npx",
      "args": ["-y", "@gitleaderboard/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
• Git Leaderboard Repository
• Model Context Protocol

License

MIT