viberank — Claude Code MCP server: features and setup
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.
MIT ★ 120 updated 2026-10-26
claude mcp add viberank -e VIBERANK_TOKEN=<VIBERANK_TOKEN> -- npx -y viberank-mcpWhat viberank 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.
What it helps with
- 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 for the agent
- Show my AI coding usage statistics.
- Submit my usage report to the viberank leaderboard.
- Show the top 20 viberank entries for Codex.
How to install viberank
Platform CLI
claude mcp add viberank -e VIBERANK_TOKEN=<VIBERANK_TOKEN> -- npx -y viberank-mcpReplace <…> with your own values
Platform CLI
codex mcp add viberank-mcp-server --env VIBERANK_TOKEN=<VIBERANK_TOKEN> -- npx -y viberank-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"viberank-mcp-server": {
"command": "npx",
"args": [
"-y",
"viberank-mcp"
],
"env": {
"VIBERANK_TOKEN": "<VIBERANK_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"viberank-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"viberank-mcp"
],
"env": {
"VIBERANK_TOKEN": "<VIBERANK_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e VIBERANK_TOKEN=<VIBERANK_TOKEN> viberank-mcp-server npx -y viberank-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about viberank
How do I install viberank in Claude Code?
Run claude mcp add viberank -e VIBERANK_TOKEN=<VIBERANK_TOKEN> -- npx -y viberank-mcp. A token links submissions to its account; without one, the server asks for a GitHub username.
What does viberank do?
It gathers local figures with ccusage@20, submits them to viberank, and retrieves leaderboard entries, developer profiles, and site-wide statistics.
What does viberank require?
It requires Node.js 18 or later and npx. Submitting without a token requires a GitHub username, and usage reports go to the viberank service. The machine also needs logs from a tool supported by ccusage to produce usage data.