gitlab-tags

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 path
    • name (Optional[str]): Optional. - Name of the tag to retrieve (e.g., 'v1.0.0')
    • search (Optional[str]): Optional. - Filter tags by search term in name
    • sort (Optional[str]): Optional. - Sort tags by criteria (e.g., 'name', 'updated')
• create_tag: Create a new tag in a GitLab project.
  • Parameters:
    • project_id (str): Optional. - Project ID or path
    • name (str): Optional. - Name of the tag to create (e.g., 'v1.0.0')
    • ref (str): Optional. - Reference (e.g., branch or commit SHA) to tag
    • message (Optional[str]): Optional. - Tag message
    • release_description (Optional[str]): Optional. - Release description associated with the tag
    • ctx (Optional[Context]): Optional. - MCP context for progress
• delete_tag: Delete a specific tag in a GitLab project.
  • Parameters:
    • project_id (str): Optional. - Project ID or path
    • name (str): Optional. - Name of the tag to delete (e.g., 'v1.0.0')
    • ctx (Optional[Context]): Optional. - MCP context for progress
• 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 path
    • name (Optional[str]): Optional. - Filter tags by name
• get_protected_tag: Retrieve details of a specific protected tag in a GitLab project.
  • Parameters:
    • project_id (str): Optional. - Project ID or path
    • name (str): Optional. - Name of the protected tag to retrieve (e.g., 'v1.0.0')
• protect_tag: Protect a specific tag in a GitLab project with specified access levels.
  • Parameters:
    • project_id (str): Optional. - Project ID or path
    • name (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 tag
    • ctx (Optional[Context]): Optional. - MCP context for progress
• unprotect_tag: Unprotect a specific tag in a GitLab project.
  • Parameters:
    • project_id (str): Optional. - Project ID or path
    • name (str): Optional. - Name of the tag to unprotect (e.g., 'v1.0.0')
    • ctx (Optional[Context]): Optional. - MCP context for progress

Usage Instructions

1. Ref for creation.

Examples

• Create: create_tag with project_id="123", name="v1.0", ref="main".
• Protect: protect_tag with create_access_level="maintainer".

Error Handling

• Tag exists: Delete first.