# Commitgraph

> Leaderboards of the most active developers on GitHub — worldwide, and by country and city —
> built from a periodic crawl and served as a static snapshot. Snapshot: 2026-08-02.

Commitgraph ranks 6,593 developers across 88 countries and 119 cities by their public plus private contributions over the trailing twelve months. Source: bootstrap. Bootstrap snapshot mapped from the public gayanvoice/top-github-users dataset. Replaced by this repository's own crawler on its first scheduled run.

## Model Context Protocol

- Endpoint: https://top-github-users-amber.vercel.app/api/mcp
- Method: POST, JSON-RPC 2.0, protocol version 2025-06-18, no authentication
- Discovery: https://top-github-users-amber.vercel.app/.well-known/mcp.json
- Tools: commitgraph_get_integration_guide, commitgraph_describe_dataset, commitgraph_list_places,
  commitgraph_get_leaderboard, commitgraph_search_developers, commitgraph_get_developer,
  commitgraph_compare_developers, commitgraph_get_organizations, commitgraph_get_rank_history,
  commitgraph_get_statistics

Call commitgraph_get_integration_guide first; it explains the dataset before you query it.

## REST

Every endpoint is GET, returns JSON, and sets access-control-allow-origin: *. Every response
carries the snapshot date it was built from.

- https://top-github-users-amber.vercel.app/api/v1 — endpoint catalogue with parameters (start here)
- https://top-github-users-amber.vercel.app/api/openapi.json — OpenAPI 3.1 description of everything below
- https://top-github-users-amber.vercel.app/api/v1/manifest — snapshot metadata, and every country and city with its aggregates
- https://top-github-users-amber.vercel.app/api/v1/leaderboard/{scope} — scope is worldwide, country:{id} or city:{id};
  the colon is percent-encoded in the path, e.g. /api/v1/leaderboard/country%3Ajapan
- https://top-github-users-amber.vercel.app/api/v1/developers — search: q, country, city, company, minContributions,
  maxContributions, minFollowers, hasProfile, sort, limit, offset
- https://top-github-users-amber.vercel.app/api/v1/developers/{login} — one developer
- https://top-github-users-amber.vercel.app/api/v1/places — kind, region, countryId, q, limit, offset
- https://top-github-users-amber.vercel.app/api/v1/places/{id} — one country or city with its leaderboard page
- https://top-github-users-amber.vercel.app/api/v1/organizations — employers ranked by their developers' contributions
- https://top-github-users-amber.vercel.app/api/v1/repositories — empty in this snapshot; the response says so
- https://top-github-users-amber.vercel.app/api/v1/history/{scope} — rank movement across snapshots
- https://top-github-users-amber.vercel.app/api/v1/statistics — dataset-wide aggregates

## What these numbers will not support

- Contribution totals and follower counts are measured. Daily calendars are measured only where the enrichment pass has run; elsewhere they are a deterministic estimate derived from the measured total, flagged with calendarSource/estimated, and the total always matches exactly. Never present an estimated calendar as observed activity.

- Country and city come from GitHub's free-text location field, which has no structured form. A city is kept only where at least eight tracked developers agree on the name. This is the largest source of error in the dataset.

- Accounts exceeding 300,000 contributions in twelve months — over 820 a day without a break — are treated as automation and excluded from every ranking. They are listed openly rather than dropped silently; see /api/v1/statistics and /methodology.

- The snapshot ranks far more logins than it stores full profile records for. A developer lookup that returns found:false with reason "no-profile" is a coverage gap, not a missing account: the leaderboard row is still returned.

- This is a periodic crawl, not a live view of GitHub. Every response carries the snapshot date it was built from.

Profile coverage in this snapshot: 2,529 of the 6,551 logins in the search index have a stored profile record. The rest are present as leaderboard rows only, and a lookup for one of them returns the row plus a note rather than a 404.

Accounts excluded as automation in this snapshot: 7. They are listed openly at https://top-github-users-amber.vercel.app/methodology.

## Pages

- https://top-github-users-amber.vercel.app/ — worldwide leaderboard and overview
- https://top-github-users-amber.vercel.app/leaderboard — the full ranking
- https://top-github-users-amber.vercel.app/countries and https://top-github-users-amber.vercel.app/cities — place indexes
- https://top-github-users-amber.vercel.app/u/{login} — a developer's profile
- https://top-github-users-amber.vercel.app/methodology — how the numbers are made, and where they are wrong