gitverse-mcp

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

Exposes 66 tools covering repositories, issues (Tasks), pull requests, releases, stars, webhooks, packages, git references, CI actions, organizations, and Smartclass — 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 |

Issue comments (Task comments)

| Tool | Description | |------|-------------| | issues_create_comment | Create a comment on an issue (Task); supports threads/review | | issues_update_comment | Update an issue comment's body | | issues_delete_comment | Delete an issue comment | | issues_create_comment_reaction | Add a reaction to an issue comment | | issues_delete_comment_reaction | Remove a reaction from an issue comment |

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 |

Webhooks

| Tool | Description | |------|-------------| | webhooks_list | List repository webhooks | | webhooks_create | Create a repository webhook | | webhooks_get | Get a webhook by ID | | webhooks_update | Update a webhook | | webhooks_delete | Delete a webhook |

Packages

| Tool | Description | |------|-------------| | packages_list_org_versions | List versions of an organization package | | packages_list_user_versions | List versions of a user package | | packages_delete_org | Delete an organization package | | packages_delete_org_version | Delete a version of an organization package | | packages_delete_user | Delete a user package | | packages_delete_user_version | Delete a version of a user package |

Git references (branches / tags)

| Tool | Description | |------|-------------| | refs_list_matching | List refs matching a prefix (e.g. heads/, tags/) | | refs_get | Get a single git reference | | refs_delete | Delete a git reference (branch or tag) |

Actions (CI)

| Tool | Description | |------|-------------| | actions_list_workflow_runs | List workflow runs (filter by actor/branch/event/status) | | actions_get_workflow_run | Get a workflow run by run ID | | actions_get_workflow_run_by_index | Get a workflow run by repository-scoped index | | actions_list_workflow_run_jobs | List jobs of a run (by run ID) | | actions_list_workflow_run_jobs_by_index | List jobs of a run (by run index) | | actions_get_workflow_job | Get a workflow job by ID | | actions_get_workflow_job_logs | Download logs of a workflow job |

Organizations

| Tool | Description | |------|-------------| | orgs_list_repositories | List repositories of an organization | | orgs_create_repository | Create a repository under an organization |

Smartclass

| Tool | Description | |------|-------------| | smartclass_get_assignment | Get a Smartclass assignment by ID |

License

MIT