# GitShine

> GitShine is a free MCP server for developer tools. Look up GitHub stats, year-in-review and profile comparisons from an AI agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://gitshine.com/docs/mcp-server
- **MCP Registry name:** com.gitshine/gitshine
- **Categories:** developer tools, analytics and data
- **Listing updated:** 2026-11-14

## About

GitShine's free server reads public GitHub data, with no key, for any username given as torvalds, @torvalds or a profile URL. Organizations are not supported. Answers link back to the matching GitShine pages.

get_github_stats returns contributions for the last 12 months and all time by year, streaks, biggest day, top languages and most-starred repositories. get_github_wrapped gives a year in review with busiest day and month and achievements. compare_github_profiles puts two users' years side by side, and get_readme_card returns the Markdown line for the animated README stats card with steps to add it.

Data comes from GitHub's public API and refreshes hourly. Each visitor is limited to 60 tool calls a minute. The server only reads and never writes to GitHub.

## Features

- **Profile stats:** Contributions, streaks, biggest day, top languages and starred repos.
- **Year in review:** Active days, busiest day and month, top repos and achievements.
- **Side-by-side compare:** Compare two users' year.
- **README card:** Gets the Markdown for an animated stats card.
- **No key needed:** Public data, no authentication.
- **Read only:** Never writes to GitHub.

## Good for

- Check a developer's contribution history
- Compare your year with a friend's
- Add a stats card to a profile README
- Summarise top languages of a GitHub user

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gitshine.com/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gitshine": {
      "serverUrl": "https://gitshine.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gitshine": {
      "type": "http",
      "url": "https://gitshine.com/mcp"
    }
  }
}
```

## Tools

- `get_github_stats`: A GitHub user's stats: contributions in the last 12 months and all time (year by year), longest and current streak, biggest day, commits/PRs/reviews/issues since joining, top languages by code size and most-starred repositories.
- `get_github_wrapped`: A GitHub user's year in review: contributions and active days, longest streak, busiest day, month and weekday, top repositories and languages, achievements and a one-line persona.
- `compare_github_profiles`: Two GitHub users' year side by side: contributions, active days, streaks, busiest month, work by type and top language.
- `get_readme_card`: The Markdown line that puts GitShine's animated stats card (contribution graph, streaks, stars, top languages) on a GitHub profile README, with step-by-step instructions for adding it. Free, no token.
- `get_repo_card`: The Markdown line for a GitShine card in a project's README, for any public GitHub repository. card=repo (default): stars, description, a year of weekly commits, open issues and pull requests. card=stars: star history, stars over time since the first one. card=contributors: avatars of the people who contributed. Includes steps for adding it.
- `get_org_card`: The Markdown line for a GitShine card in a GitHub organization's profile README: total stars, top three repositories, how many are active this month and the main languages. Includes steps for adding it.

## FAQ

### Does it need authentication?

No, it reads public GitHub data without a key.

### How often does data refresh?

Hourly, from GitHub's public API.

### What are the rate limits?

60 tool calls per minute per visitor.

### Can it look up organizations?

No, only users.

### Is GitShine free?

Yes. GitShine is free to use.

### How do I add GitShine to Claude Code?

Run this command in your terminal: claude mcp add --transport http gitshine https://gitshine.com/mcp

### What are the best alternatives to GitShine?

The closest alternatives to GitShine are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/gitshine
