| name | gitlab-tags |
| description | Manages GitLab tags. Use for creating, deleting, protecting tags. Triggers: versioning. |
Overview
Handles tags and protection.
Available Tools
get_tags: Retrieve a list of tags for a specific GitLab project, optionally filtered or sorted or Retrieve details of a specific tag in a GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathname(Optional[str]): Optional. - Name of the tag to retrieve (e.g., 'v1.0.0')search(Optional[str]): Optional. - Filter tags by search term in namesort(Optional[str]): Optional. - Sort tags by criteria (e.g., 'name', 'updated')
- Parameters:
create_tag: Create a new tag in a GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathname(str): Optional. - Name of the tag to create (e.g., 'v1.0.0')ref(str): Optional. - Reference (e.g., branch or commit SHA) to tagmessage(Optional[str]): Optional. - Tag messagerelease_description(Optional[str]): Optional. - Release description associated with the tagctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
delete_tag: Delete a specific tag in a GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathname(str): Optional. - Name of the tag to delete (e.g., 'v1.0.0')ctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
get_protected_tags: Retrieve a list of protected tags in a specific GitLab project, optionally filtered by name.- Parameters:
project_id(str): Optional. - Project ID or pathname(Optional[str]): Optional. - Filter tags by name
- Parameters:
get_protected_tag: Retrieve details of a specific protected tag in a GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathname(str): Optional. - Name of the protected tag to retrieve (e.g., 'v1.0.0')
- Parameters:
protect_tag: Protect a specific tag in a GitLab project with specified access levels.- Parameters:
project_id(str): Optional. - Project ID or pathname(str): Optional. - Name of the tag to protect (e.g., 'v1.0.0')create_access_level(Optional[str]): Optional. - Access level for creating the tag (e.g., 'maintainer')allowed_to_create(Optional[List[Dict]]): Optional. - List of users or groups allowed to create the tagctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
unprotect_tag: Unprotect a specific tag in a GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathname(str): Optional. - Name of the tag to unprotect (e.g., 'v1.0.0')ctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
Usage Instructions
- Ref for creation.
Examples
- Create:
create_tagwith project_id="123", name="v1.0", ref="main". - Protect:
protect_tagwith create_access_level="maintainer".
Error Handling
- Tag exists: Delete first.