Sitios Geo

Geo replica una instancia de GitLab en otros sitios. Estas acciones gestionan los sitios (listar, leer, crear, editar y borrar), reparan la aplicación OAuth de un sitio y leen el estado de replicación de un sitio o de todos. Son acciones de administrador.

Preguntas de ejemplo

• “Lista los sitios Geo”
• “¿Cuál es el estado de replicación del sitio Geo 2?”
• “Repara la aplicación OAuth del sitio secundario”

Cómo llamarlo

• Dinámica, la superficie predeterminada: llama a gitlab_execute_action con action igual al ID de la acción, como geo.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_geo 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_geo_site, pasándole directamente sus parámetros.

Disponibilidad

Cuántas de estas acciones sirve una instancia en cada nivel, de un total de 8:

• Free: 0
• Premium: 8
• Ultimate: 8

Solo se lista para un token que tenga admin_mode: el servidor quita el grupo de todas las superficies a un token cuyos ámbitos conoce y que no lo tiene.

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

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
geo.create	gitlab_create_geo_site
geo.delete	gitlab_delete_geo_site
geo.edit	gitlab_edit_geo_site
geo.get	gitlab_get_geo_site
geo.get_status	gitlab_get_status_geo_site
geo.list	gitlab_list_geo_sites
geo.list_status	gitlab_list_status_all_geo_sites
geo.repair	gitlab_repair_geo_site

geo.create

Create a new Geo site. Returns: the site with id, name, url, primary/enabled flags, capacities, selective-sync settings, and navigation links. See also: geo.list, geo.get, geo.edit.

• Meta-herramienta: gitlab_geo, acción create
• Herramienta individual: gitlab_create_geo_site
• Nivel: Premium
• Token clásico u OAuth: api; este servidor solo lista el grupo a un token que lleve además admin_mode
• Token de grano fino: Geo Site: Create en instancia (página de permisos)
• Comportamiento: escribe, no idempotente

Parámetro	Tipo	Requerido	Descripción
name	string	sí	Unique name of the Geo site
url	string	sí	External URL of the Geo site
container_repositories_max_capacity	integer	no	Max number of concurrent container repository syncs
enabled	boolean	no	Whether the site is enabled
files_max_capacity	integer	no	Max number of LFS/attachment backfill downloads
internal_url	string	no	Internal URL of the Geo site
minimum_reverification_interval	integer	no	Minimum interval (days) before re-verification
primary	boolean	no	Whether this is a primary site
repos_max_capacity	integer	no	Max number of concurrent repository backfill syncs
selective_sync_namespace_ids	integer[]	no	Namespace IDs to sync (when selective_sync_type=namespaces)
selective_sync_shards	string[]	no	Storage shards to sync (when selective_sync_type=shards)
selective_sync_type	string	no	Selective sync type: namespaces or shards
sync_object_storage	boolean	no	Whether to sync object-stored data
verification_max_capacity	integer	no	Max number of concurrent verification jobs

geo.delete

Delete a Geo site permanently. Returns: a success confirmation naming the site. See also: geo.get, geo.list.

• Meta-herramienta: gitlab_geo, acción delete
• Herramienta individual: gitlab_delete_geo_site
• Nivel: Premium
• Token clásico u OAuth: api; este servidor solo lista el grupo a un token que lleve además admin_mode
• Token de grano fino: Geo Site: Delete en instancia (página de permisos)
• Comportamiento: escribe, destructiva (necesita confirmación), idempotente

Parámetro	Tipo	Requerido	Descripción
id	integer	sí	Numeric ID of the Geo site

geo.edit

Edit a Geo site’s settings. Returns: the updated site with its capacities and selective-sync configuration. See also: geo.get, geo.list, geo.repair.

• Meta-herramienta: gitlab_geo, acción edit
• Herramienta individual: gitlab_edit_geo_site
• Nivel: Premium
• Token clásico u OAuth: api; este servidor solo lista el grupo a un token que lleve además admin_mode
• Token de grano fino: Geo Site: Update en instancia (página de permisos)
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
id	integer	sí	Numeric ID of the Geo site
container_repositories_max_capacity	integer	no	Max number of concurrent container repository syncs
enabled	boolean	no	Whether the site is enabled
files_max_capacity	integer	no	Max number of LFS/attachment backfill downloads
internal_url	string	no	Internal URL of the Geo site
minimum_reverification_interval	integer	no	Minimum interval (days) before re-verification
name	string	no	Unique name of the Geo site
repos_max_capacity	integer	no	Max number of concurrent repository backfill syncs
selective_sync_namespace_ids	integer[]	no	Namespace IDs to sync
selective_sync_shards	string[]	no	Storage shards to sync
selective_sync_type	string	no	Selective sync type: namespaces or shards
url	string	no	External URL of the Geo site
verification_max_capacity	integer	no	Max number of concurrent verification jobs

geo.get

Get a single Geo site by id. Returns: the site with name, url, primary/enabled flags, capacities, selective-sync settings, and navigation links. See also: geo.list, geo.edit, geo.get_status.

• Meta-herramienta: gitlab_geo, acción get
• Herramienta individual: gitlab_get_geo_site
• Nivel: Premium
• Token clásico u OAuth: read_api (o api); este servidor solo lista el grupo a un token que lleve además admin_mode
• Token de grano fino: Geo Site: Read en instancia (página de permisos)
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
id	integer	sí	Numeric ID of the Geo site

geo.get_status

Get replication status for one Geo site. Returns: health, replication lag, and detailed sync/verification/checksum counts and percentages plus navigation links. See also: geo.list_status, geo.get.

• Meta-herramienta: gitlab_geo, acción get_status
• Herramienta individual: gitlab_get_status_geo_site
• Nivel: Premium
• Token clásico u OAuth: read_api (o api); este servidor solo lista el grupo a un token que lleve además admin_mode
• Token de grano fino: Geo Site: Read en instancia (página de permisos)
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
id	integer	sí	Numeric ID of the Geo site

geo.list

List all Geo sites. Returns: each site with id, name, url, primary/enabled flags, capacities, and pagination metadata. See also: geo.get, geo.list_status, geo.create.

• Meta-herramienta: gitlab_geo, acción list
• Herramienta individual: gitlab_list_geo_sites
• Nivel: Premium
• Token clásico u OAuth: read_api (o api); este servidor solo lista el grupo a un token que lleve además admin_mode
• Token de grano fino: Geo Site: Read en instancia (página de permisos)
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
order_by	string	no	Column to order results by (keyset pagination)
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Next page of a keyset listing: the next_page_token of the previous response of this action, passed back unchanged. It carries the position and every filter of the listing as GitLab read them, and those are what the next page is asked with, whatever filters are sent beside it. Leave it empty for the first page.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost, and a keyset page names the next one in next_page_token rather than next_page.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
sort	string (asc, desc)	no	Sort direction (asc, desc)

geo.list_status

List replication status for all Geo sites. Returns: per-site health, replication lag, and detailed sync/verification/checksum counts and percentages, with pagination metadata. See also: geo.get_status, geo.list.

• Meta-herramienta: gitlab_geo, acción list_status
• Herramienta individual: gitlab_list_status_all_geo_sites
• Nivel: Premium
• Token clásico u OAuth: read_api (o api); este servidor solo lista el grupo a un token que lleve además admin_mode
• Token de grano fino: Geo Site: Read en instancia (página de permisos)
• Comportamiento: solo lectura, idempotente

Parámetro	Tipo	Requerido	Descripción
order_by	string	no	Column to order results by (keyset pagination)
page	integer	no	Page number to fetch, 1-based. Defaults to 1. Use the next_page field from the previous response to paginate forward.
page_token	string	no	Next page of a keyset listing: the next_page_token of the previous response of this action, passed back unchanged. It carries the position and every filter of the listing as GitLab read them, and those are what the next page is asked with, whatever filters are sent beside it. Leave it empty for the first page.
pagination	string	no	Pagination method: ‘keyset’ for keyset-based pagination on large ordered result sets, or ‘offset’ (the default). Keyset avoids deep-offset cost, and a keyset page names the next one in next_page_token rather than next_page.
per_page	integer	no	Items per page. Defaults to 20, minimum 1, maximum 100. Use 100 to minimize round trips when the result set is large.
sort	string (asc, desc)	no	Sort direction (asc, desc)

geo.repair

Repair a Geo site’s OAuth application. Returns: the repaired site (or a hint to refresh via get when GitLab returns no body). See also: geo.get, geo.get_status.

• Meta-herramienta: gitlab_geo, acción repair
• Herramienta individual: gitlab_repair_geo_site
• Nivel: Premium
• Token clásico u OAuth: api; este servidor solo lista el grupo a un token que lleve además admin_mode
• Token de grano fino: Geo Site: Repair en instancia (página de permisos)
• Comportamiento: escribe, idempotente

Parámetro	Tipo	Requerido	Descripción
id	integer	sí	Numeric ID of the Geo site