# viberank

viberank is an MCP server for Claude Code that submits AI tool usage stats to a leaderboard and retrieves developer profiles. The agent fetches data on request.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 120 repo stars
- Author: sculptdotfun
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sculptdotfun/viberank/tree/HEAD/packages/viberank-mcp-server
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/viberank

## What it does

The server runs `ccusage@20` locally to collect usage figures, then offers tools to submit a report or read the leaderboard, a profile, and site-wide stats. Read requests do not upload usage; only the submission tool does.

Setup requires Node.js 18 or later and `npx`. Without a token, submissions need a GitHub username that becomes a public profile; a token files them under its owner and marks them verified. Local logs from Claude Code, Codex, or another tool supported by `ccusage` are needed to produce usage data.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `VIBERANK_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add viberank -e VIBERANK_TOKEN=<VIBERANK_TOKEN> -- npx -y viberank-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add viberank-mcp-server --env VIBERANK_TOKEN=<VIBERANK_TOKEN> -- npx -y viberank-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "viberank-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "viberank-mcp"
            ],
            "env": {
                "VIBERANK_TOKEN": "<VIBERANK_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "viberank-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "viberank-mcp"
            ],
            "env": {
                "VIBERANK_TOKEN": "<VIBERANK_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VIBERANK_TOKEN=<VIBERANK_TOKEN> viberank-mcp-server npx -y viberank-mcp
```
Replace <…> with your own values

## When to use it
- collect local cost and token figures by coding tool
- submit an AI usage report to the viberank leaderboard
- retrieve a developer's rank and public profile
- compare usage with site-wide statistics

## Example prompts
- Show my AI coding usage statistics.
- Submit my usage report to the viberank leaderboard.
- Show the top 20 viberank entries for Codex.

## Similar
- [claude-usage-analyst](https://affpapa.org/en/nevibecode/skills/claude-usage-analyst.md) — skill · 471 installs
- [caveman-stats](https://affpapa.org/en/nevibecode/skills/caveman-stats.md) — skill · 385600 installs
- [productivity-coach](https://affpapa.org/en/nevibecode/agents/productivity-coach.md) — subagent · ★ 1198 repo stars
- [usage-trends](https://affpapa.org/en/nevibecode/skills/usage-trends.md) — skill · ★ 1198 repo stars
- [ponytail-gain](https://affpapa.org/en/nevibecode/skills/ponytail-gain.md) — skill · 57000 installs
- [alethe](https://affpapa.org/en/nevibecode/skills/alethe.md) — skill · 1100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
