Emoji personalizados

Los emoji personalizados de un grupo son imágenes que añade a los emoji con los que sus proyectos pueden reaccionar y escribir en Markdown. Estas acciones los listan, los añaden y los borran. Reaccionar con un emoji a un issue, a un merge request o a un snippet no es una de ellas: son acciones de los grupos de issues, merge requests y snippets. Borrar un emoji deja en su sitio las reacciones que lo usaban, mostradas como su :name:.

Preguntas de ejemplo

• “Lista los emoji personalizados del grupo platform”
• “Añade un emoji party_parrot al grupo platform”
• “Borra el emoji personalizado obsoleto”

Cómo llamarlo

• Dinámica, la superficie predeterminada: llama a gitlab_execute_action con action igual al ID de la acción, como custom_emoji.create, y sus parámetros en params. gitlab_find_action encuentra un ID a partir de una descripción de la tarea.
• Meta (GITLAB_MCP_TOOL_SURFACE=meta): llama a gitlab_custom_emoji con action igual al nombre de la acción, como create, y sus parámetros en params.
• Individual (GITLAB_MCP_TOOL_SURFACE=individual): llama a la herramienta propia de la acción, como gitlab_create_custom_emoji, pasándole directamente sus parámetros.

Disponibilidad

Todos los niveles sirven el grupo completo, tanto en instancias autogestionadas como en GitLab.com.

Acciones de solo lectura: 1 de 3, las que conserva un despliegue en modo de solo lectura. A un token con read_api y sin api se le sirven 1 de las 3.

Acciones

La descripción de cada acción, y la de cada uno de sus parámetros, es el texto que sirve el servidor para ella en la superficie predeterminada, citado tal cual; por eso está en inglés. Las líneas de token dicen lo que exige GitLab 19.4.1 a un token para las peticiones que envía cada acción; en una instancia con Admin Mode activado, una acción que solo puede ejecutar un administrador necesita además admin_mode. Una acción destructiva solo se ejecuta una vez confirmada, salvo que GITLAB_MCP_YOLO_MODE (o AUTOPILOT) se salte ese paso: la superficie dinámica necesita confirm: true en gitlab_execute_action, y las otras dos aceptan un parámetro confirm o la pregunta del cliente (Acciones destructivas).

Acción	Individual
custom_emoji.create	gitlab_create_custom_emoji
custom_emoji.delete	gitlab_delete_custom_emoji
custom_emoji.list	gitlab_list_custom_emoji

custom_emoji.create

Create group-level custom emoji using GraphQL-backed routes.

• Meta-herramienta: gitlab_custom_emoji, acción create
• Herramienta individual: gitlab_create_custom_emoji
• Nivel: Free
• Token clásico u OAuth: api
• Token de grano fino: No alcanzable en esta versión: GitLab no declara ningún permiso de grano fino para CustomEmoji en la respuesta, así que la escritura se confirma y su respuesta se pierde (página de permisos)
• Comportamiento: escribe, no idempotente

Parámetro	Tipo	Requerido	Descripción
group_path	string	sí	Group full path (e.g. my-group)
name	string	sí	Emoji name without colons (e.g. party_parrot)
url	string	sí	URL to the emoji image (PNG or GIF recommended)

custom_emoji.delete

Delete group-level custom emoji using GraphQL-backed routes.

• Meta-herramienta: gitlab_custom_emoji, acción delete
• Herramienta individual: gitlab_delete_custom_emoji
• Nivel: Free
• Token clásico u OAuth: api
• Token de grano fino: No alcanzable en esta versión: GitLab no declara ningún permiso de grano fino para CustomEmoji en la respuesta, así que la escritura se confirma y su respuesta se pierde (página de permisos)
• Comportamiento: escribe, destructiva (necesita confirmación), idempotente

Parámetro	Tipo	Requerido	Descripción
id	string	sí	Custom emoji GID (e.g. gid://gitlab/CustomEmoji/1)

custom_emoji.list

List group-level custom emoji using GraphQL-backed routes. A subgroup is listed with its own emoji only, as GitLab defaults. Set include_ancestor_groups to true to add the emoji of its ancestor groups, which it can use as well.

• Meta-herramienta: gitlab_custom_emoji, acción list
• Herramienta individual: gitlab_list_custom_emoji
• Nivel: Free
• Token clásico u OAuth: read_api (o api)
• Token de grano fino: No alcanzable en esta versión: GitLab no declara ningún permiso de grano fino para CustomEmoji, del que está hecha la respuesta (página de permisos)
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
group_path	string	sí	Group full path (e.g. my-group)
after	string	no	Cursor for forward pagination (from previous response end_cursor)
before	string	no	Cursor for backward pagination (from previous response start_cursor). The page size comes from last, or from first when last is omitted
first	integer	no	Number of items to return (default 20, max 100)
include_ancestor_groups	boolean	no	Also list the custom emoji of every ancestor group, which a subgroup can use as well. Default false, as GitLab defaults: a subgroup is then listed with its own emoji only
last	integer	no	Number of items to return from the end of the range (backward pagination). Cannot be combined with first