gitlab_list_tags
Retrieve and organize repository tags with commit details on MCP GitLab Server. View sorted tags by name, date, or semantic version to identify releases and versions efficiently.
Instructions
List repository tags Returns: Tags with commit info Use when: Finding releases, version tags Sorting: By name, date, semver
Example response: [{ "name": "v2.0.0", "message": "Version 2.0.0 release", "commit": { "id": "abc123...", "short_id": "abc123", "title": "Prepare 2.0.0 release" }, "release": { "tag_name": "v2.0.0", "description": "Major release with new features..." } }]
Related tools:
- gitlab_list_releases: Full release info
- gitlab_create_tag: Create new tag
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order_by | No | Tag ordering field Type: string (enum) Options: - 'name': Alphabetical order - 'updated': Last updated first - 'version': Version string comparison - 'semver': Semantic version sorting Default: 'updated' Examples: - 'name': a-tag, b-tag, c-tag - 'semver': v1.0.0, v1.1.0, v2.0.0 | updated |
| project_id | No | Project identifier (auto-detected if not provided) Type: integer OR string Format: numeric ID or 'namespace/project' Optional: Yes - auto-detects from current git repository Examples: - 12345 (numeric ID) - 'gitlab-org/gitlab' (namespace/project path) - 'my-group/my-subgroup/my-project' (nested groups) Note: If in a git repo with GitLab remote, this can be omitted | |
| sort | No | Sort direction Type: string (enum) Options: 'asc' | 'desc' Default: Varies by context (usually 'desc' for time-based) Examples: - 'asc': A→Z, oldest→newest, smallest→largest - 'desc': Z→A, newest→oldest, largest→smallest | desc |