gitverse-mcp

MCP server for the GitVerse API, built on top of @onreza/gitverse-sdk.

Exposes 40+ tools covering repositories, issues, pull requests, releases, stars, and users — all accessible via the Model Context Protocol.

Quick start

npx (no install required)

npx gitverse-mcp

Global install

npm install -g gitverse-mcp
gitverse-mcp

Configuration

Set your GitVerse personal access token before starting the server:

export GITVERSE_TOKEN=your_token_here

Claude Desktop / Cursor / other MCP clients

Add to your MCP client config:

{
  "mcpServers": {
    "gitverse": {
      "command": "npx",
      "args": ["-y", "gitverse-mcp"],
      "env": {
        "GITVERSE_TOKEN": "your_token_here"
      }
    }
  }
}

Available tools

Users

| Tool | Description | |------|-------------| | users_get_authenticated | Get the authenticated user's profile | | users_get_by_username | Get a user by username | | users_search | Search users by keyword |

Repositories

| Tool | Description | |------|-------------| | repos_list | List repos for the authenticated user | | repos_get | Get a repository | | repos_create | Create a new repository | | repos_update | Update a repository | | repos_delete | Delete a repository | | repos_list_branches | List branches | | repos_list_commits | List commits | | repos_get_commit | Get a single commit by SHA | | repos_compare_commits | Compare two commits / branches | | repos_get_content | Get a file or directory contents | | repos_create_or_update_file | Create or update a file (base64 content) | | repos_delete_file | Delete a file | | repos_list_collaborators | List collaborators | | repos_list_languages | List languages used |

Issues

| Tool | Description | |------|-------------| | issues_list | List issues | | issues_get | Get an issue by index | | issues_list_comments | List issue comments | | issues_list_labels | List issue labels |

Pull Requests

| Tool | Description | |------|-------------| | pulls_list | List pull requests | | pulls_get | Get a pull request | | pulls_create | Create a pull request | | pulls_list_commits | List PR commits | | pulls_list_files | List files changed in a PR | | pulls_is_merged | Check if a PR is merged |

Releases

| Tool | Description | |------|-------------| | releases_list | List releases | | releases_get | Get a release by ID | | releases_get_by_tag | Get a release by tag name | | releases_create | Create a release | | releases_update | Update a release | | releases_delete | Delete a release |

Stars

| Tool | Description | |------|-------------| | stars_list | List starred repositories | | stars_is_starred | Check if a repo is starred | | stars_star | Star a repository | | stars_unstar | Unstar a repository |

License

MIT