GitShine MCP server 🤖

Connect AI agents to GitShine to look up GitHub stats, Wrapped and profile comparisons, and add the README stats card, with no key.


GitShine runs a free MCP server, so AI agents like Claude, Cursor and VS Code can use GitShine directly. Ask "what are torvalds' GitHub stats?", "compare my 2026 with gaearon's" or "add a GitHub stats card to my profile README", and the agent answers from GitShine's data, with links to the matching pages.

  • Server URL: https://gitshine.com/mcp (Streamable HTTP)
  • Authentication: none. It reads public GitHub data, the same as the site.
  • Cost: free.

Tools

ToolWhat it returns
get_github_statsA user's contributions (last 12 months and all time, by year), streaks, biggest day, top languages and most-starred repositories
get_github_wrappedA user's year in review: active days, streaks, busiest day and month, top repos and languages, achievements
compare_github_profilesTwo users' year side by side
get_readme_cardThe Markdown line for the animated README stats card, with steps to add it

Usernames can be given as torvalds, @torvalds or a profile URL. Organizations aren't supported.

Add it to your agent

Claude Code

claude mcp add --transport http gitshine https://gitshine.com/mcp

Claude (claude.ai and the desktop app)

Open Settings → Connectors → Add custom connector, name it GitShine and use the URL https://gitshine.com/mcp.

Cursor

Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "gitshine": { "url": "https://gitshine.com/mcp" }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "gitshine": { "type": "http", "url": "https://gitshine.com/mcp" }
  }
}

Any other client that supports remote MCP servers over HTTP works the same way with the URL above.

Limits

Data comes from GitHub's public API and refreshes hourly. Each visitor can make 60 tool calls a minute. The server only reads; it never writes to GitHub or changes anything for you. Adding the README card is done by your agent, in your own repository.