# repository — gitlab

> 41 acciones
> Esta página en markdown. Índice: https://mcp.jmrp.io/llms.txt

Canonical: https://mcp.jmrp.io/es/servers/gitlab/actions/repository/
Language: es
Alternate: https://mcp.jmrp.io/servers/gitlab/actions/repository/index.md
Updated: 2026-09-11T09:56:41+02:00
License: https://mcp.jmrp.io/es/license/

Contado con un token Free contra gitlab.com, que es el único host con el que habla este endpoint: para usarlo contra una instancia self-managed, levanta tú el servidor — su documentación lo cubre. El catálogo depende del token que pregunta, así que el recuento se mueve con su tier y con sus permisos: los tiers superiores exponen más acciones, y los dominios de administración solo aparecen a tokens autorizados a usarlos. Por eso las cifras difieren en otros sitios: el proyecto upstream cataloga 1.006 acciones en 162 dominios, y 851 en la superficie Free/CE, mientras que este despliegue publica 747 porque es solo-OAuth y actúa con tu token, así que los dominios de administración que una cuenta sin admin no puede llamar no aparecen nunca. Las tres describen el mismo catálogo, contado desde tres sitios distintos.

## Acciones

### `repository.archive` — Repository Archive

_solo lectura_

Build the download URL for a repository archive. Returns: the project, ref/SHA, format, and archive download URL (binary content is not returned). See also: repository.tree, tag.list.

**Parámetros obligatorios:** `project_id (string)`

### `repository.blob` — Repository Blob

_solo lectura_

Get a git blob by SHA. Returns: blob SHA, byte size, decoded text content (or image data), and a content category (text/image/binary). See also: repository.raw_blob, repository.tree.

**Parámetros obligatorios:** `project_id (string)`, `sha (string)`

### `repository.changelog_add` — Repository Changelog Add

Add changelog data to a changelog file by committing the generated entries. Returns: a success confirmation with the version. See also: repository.changelog_generate, release.create.

**Parámetros obligatorios:** `project_id (string)`, `version (string)`

### `repository.changelog_generate` — Repository Changelog Generate

_solo lectura_

Generate changelog notes for a version range without committing. Returns: the rendered changelog notes (read-only preview). See also: repository.changelog_add, release.create.

**Parámetros obligatorios:** `project_id (string)`, `version (string)`

### `repository.commit_cherry_pick` — Commit Cherry Pick

Cherry-pick a commit onto a target branch, optionally as a dry run. Returns: the newly created commit (SHA, title, author, dates, web URL) or a conflict error. See also: repository.commit_get, branch.list, repository.commit_revert.

**Parámetros obligatorios:** `branch (string)`, `project_id (string)`

### `repository.commit_comment_create` — Commit Comment Create

Post a comment on a commit, optionally inline on a specific file path and line. Returns: the created comment with note text, author user object, and optional path/line/line_type. See also: repository.commit_comments, repository.commit_diff, repository.commit_get.

**Parámetros obligatorios:** `note (string)`, `project_id (string)`, `sha (string)`

### `repository.commit_comments` — Commit Comments

_solo lectura_

List the comments on a commit. Returns: comment entries with note text, author user object, optional file path, line, and line type, plus pagination metadata. See also: repository.commit_comment_create, repository.commit_get, repository.commit_diff.

**Parámetros obligatorios:** `project_id (string)`, `sha (string)`

### `repository.commit_create` — Commit Create

Create a commit with multiple file actions (create/update/delete/move/chmod) on a branch in one call. Returns: the created commit with SHA, title, author/committer, dates, parent IDs, stats, trailers, and web URL. See also: branch.list, repository.tree, repository.commit_get.

**Parámetros obligatorios:** `actions (array)`, `branch (string)`, `commit_message (string)`, `project_id (string)`

### `repository.commit_diff` — Commit Diff

_solo lectura_

Get the file diffs of a single commit, optionally in unified-diff format. Returns: per-file diffs (old/new path, diff body, new/renamed/deleted flags, file modes) with pagination metadata. See also: repository.commit_get, repository.file_history, repository.commit_comments.

**Parámetros obligatorios:** `project_id (string)`, `sha (string)`

### `repository.commit_discussion_add_note` — Add Commit Discussion Note

Add a reply note to an existing commit discussion thread. Returns: the created note (author, body, timestamps, resolvable state). See also: repository.commit_discussion_create, repository.commit_discussion_get, repository.commit_discussion_update_note.

**Parámetros obligatorios:** `body (string)`, `commit_sha (string)`, `discussion_id (string)`, `project_id (string)`

### `repository.commit_discussion_create` — Create Commit Discussion

Create a new discussion thread on a commit, optionally as an inline diff comment. Returns: the created thread with its first note (author, body, resolvable state, diff position). See also: repository.commit_discussion_add_note, repository.commit_discussion_list, repository.commit_diff.

**Parámetros obligatorios:** `body (string)`, `commit_sha (string)`, `project_id (string)`

### `repository.commit_discussion_delete_note` — Delete Commit Discussion Note

_destructiva_

Delete a note from a commit discussion thread (destructive). Returns: a deletion confirmation message. See also: repository.commit_discussion_update_note, repository.commit_discussion_get, repository.commit_discussion_list.

**Parámetros obligatorios:** `commit_sha (string)`, `discussion_id (string)`, `note_id (integer)`, `project_id (string)`

### `repository.commit_discussion_get` — Get Commit Discussion

_solo lectura_

Get a single commit discussion thread by its discussion id. Returns: the thread with every note (author, body, system flag, resolvable/resolved state, diff position). See also: repository.commit_discussion_list, repository.commit_discussion_add_note, repository.commit_get.

**Parámetros obligatorios:** `commit_sha (string)`, `discussion_id (string)`, `project_id (string)`

### `repository.commit_discussion_list` — List Commit Discussions

_solo lectura_

List discussion threads on a commit with ordering and keyset pagination. Returns: discussion threads with their notes (author, body, system flag, resolvable state, diff position) and pagination metadata. See also: repository.commit_discussion_get, repository.commit_discussion_create, repository.commit_get.

**Parámetros obligatorios:** `commit_sha (string)`, `project_id (string)`

### `repository.commit_discussion_update_note` — Update Commit Discussion Note

Update the body of a note in a commit discussion thread. Returns: the updated note (author, body, timestamps). See also: repository.commit_discussion_add_note, repository.commit_discussion_delete_note, repository.commit_discussion_get.

**Parámetros obligatorios:** `body (string)`, `commit_sha (string)`, `discussion_id (string)`, `note_id (integer)`, `project_id (string)`

### `repository.commit_get` — Commit Get

_solo lectura_

Get a single commit from a project by SHA (full, short, branch, or tag). Returns: full commit metadata, message, parent IDs, author/committer, dates, stats, trailers, project ID, and last pipeline. See also: repository.file_history, repository.commit_diff, repository.commit_refs, repository.commit_statuses.

**Parámetros obligatorios:** `project_id (string)`, `sha (string)`

### `repository.commit_list` — Commit List

_solo lectura_

List repository commits for a project, optionally filtered by ref_name, since/until, path, or author. Returns: commit summaries (SHA, title, author, dates, parent IDs, stats, trailers, last pipeline) with pagination metadata. See also: repository.commit_get, repository.commit_diff, repository.commit_statuses, branch.list.

**Parámetros obligatorios:** `project_id (string)`

### `repository.commit_merge_requests` — Commit Merge Requests

_solo lectura_

List merge requests associated with a commit. Returns: basic MR entries with IID, title, state, source/target branches, web URL, and author. See also: repository.commit_get, merge_request.get, mr_review.changes_get.

**Parámetros obligatorios:** `project_id (string)`, `sha (string)`

### `repository.commit_refs` — Commit Refs

_solo lectura_

List branches and tags that reference (contain) a commit, optionally filtered by ref type. Returns: ref entries with type and name plus pagination metadata. See also: repository.commit_get, branch.list, tag.list.

**Parámetros obligatorios:** `project_id (string)`, `sha (string)`

### `repository.commit_revert` — Commit Revert

Revert a commit on a target branch, creating a new commit that undoes it. Returns: the newly created revert commit (SHA, title, author, dates, web URL) or a conflict error. See also: repository.commit_get, branch.list, repository.commit_cherry_pick.

**Parámetros obligatorios:** `branch (string)`, `project_id (string)`

### `repository.commit_signature` — Commit Signature

_solo lectura_

Get the signature (GPG/X.509/SSH) of a commit for authenticity verification. Returns: the signing key ID, primary key ID, signer name/email, verification status, and optional subkey ID. See also: repository.commit_get, repository.file_history.

**Parámetros obligatorios:** `project_id (string)`, `sha (string)`

### `repository.commit_status_set` — Commit Status Set

Set or update the pipeline status of a commit (used by external CI/reporting integrations). Returns: the resulting status with state, name, ref, coverage, pipeline ID, timestamps, and author user object. See also: repository.commit_statuses, repository.commit_get, pipeline.list.

**Parámetros obligatorios:** `project_id (string)`, `sha (string)`, `state (string)`

### `repository.commit_statuses` — Commit Statuses

_solo lectura_

List the statuses of a commit (CI jobs and external integrations), filtered by ref, stage, name, or pipeline. Returns: status entries with state, name, ref, coverage, pipeline ID, timestamps, and author user object, plus pagination metadata. See also: repository.commit_status_set, repository.commit_get, pipeline.list.

**Parámetros obligatorios:** `project_id (string)`, `sha (string)`

### `repository.compare` — Repository Compare

_solo lectura_

Compare two refs (branches, tags, or commits) in a project. Use from_project_id for cross-project comparison. Returns: commits, diffs, and comparison metadata. See also: repository.tree, branch.list.

**Parámetros obligatorios:** `from (string)`, `project_id (string)`, `to (string)`

### `repository.contributors` — Repository Contributors

_solo lectura_

List repository contributors. Returns: each contributor's name, email, commit count, additions, deletions, and pagination metadata. See also: repository.tree, repository.file_history.

**Parámetros obligatorios:** `project_id (string)`

### `repository.file_blame` — File Blame

_solo lectura_

Get blame information for a file, optionally for a line range. Returns: file_path and blame ranges, each with commit id, message, author name/email, authored and committed dates, and the covered lines. See also: repository.file_get, repository.file_history.

**Parámetros obligatorios:** `file_path (string)`, `project_id (string)`

### `repository.file_create` — File Create

Create a new file in a repository in a single commit. Returns: file_path, branch, commit_id, and last_commit_id. See also: repository.file_update, repository.file_get, repository.file_delete.

**Parámetros obligatorios:** `branch (string)`, `commit_message (string)`, `content (string)`, `file_path (string)`, `project_id (string)`

### `repository.file_delete` — File Delete

_destructiva_

Delete a file from a repository in a single commit. Returns: a success confirmation naming the file and project. See also: repository.file_get, repository.file_update.

**Parámetros obligatorios:** `branch (string)`, `commit_message (string)`, `file_path (string)`, `project_id (string)`

### `repository.file_get` — File Get

_solo lectura_

Get a single file's decoded content and metadata from a repository. Returns: file_name, file_path, size, encoding, content, content_sha256, ref, blob_id, commit_id, last_commit_id, and execute_filemode. See also: repository.file_raw, repository.file_metadata, repository.file_blame, repository.tree.

**Parámetros obligatorios:** `file_path (string)`, `project_id (string)`

### `repository.file_history` — Commit List

_solo lectura_

List repository commits for a project, optionally filtered by ref_name, since/until, path, or author. Returns: commit summaries (SHA, title, author, dates, parent IDs, stats, trailers, last pipeline) with pagination metadata. See also: repository.commit_get, repository.commit_diff, repository.commit_statuses, branch.list.

**Parámetros obligatorios:** `project_id (string)`

**alias de:** `repository.commit_list` (repository)

### `repository.file_metadata` — File Metadata

_solo lectura_

Get a file's metadata without content (HEAD request). Returns: file_name, file_path, size, encoding, ref, blob_id, commit_id, last_commit_id, execute_filemode, and content_sha256. See also: repository.file_get, repository.file_raw_metadata.

**Parámetros obligatorios:** `file_path (string)`, `project_id (string)`

### `repository.file_raw` — File Raw

_solo lectura_

Get the raw content of a file from a repository. Returns: file_path, size, content, and content_category. See also: repository.file_get, repository.file_raw_metadata.

**Parámetros obligatorios:** `file_path (string)`, `project_id (string)`

### `repository.file_raw_metadata` — File Raw Metadata

_solo lectura_

Get raw file metadata without content (HEAD request to the raw endpoint). Returns: file_name, file_path, size, encoding, ref, blob_id, commit_id, last_commit_id, execute_filemode, and content_sha256. See also: repository.file_raw, repository.file_metadata.

**Parámetros obligatorios:** `file_path (string)`, `project_id (string)`

### `repository.file_update` — File Update

Update an existing file in a repository in a single commit. Returns: file_path, branch, commit_id, and last_commit_id. See also: repository.file_create, repository.file_get, repository.file_delete.

**Parámetros obligatorios:** `branch (string)`, `commit_message (string)`, `content (string)`, `file_path (string)`, `project_id (string)`

### `repository.list_submodules` — List Repository Submodules

_solo lectura_

List the Git submodules defined in a repository's .gitmodules. Returns: each submodule's name, path, remote url, resolved_project, and pinned commit_sha, plus a count. See also: repository.read_submodule_file, repository.update_submodule, repository.tree.

**Parámetros obligatorios:** `project_id (string)`

### `repository.markdown_render` — Render Markdown

_solo lectura_

Render arbitrary Markdown text to HTML using the GitLab Markdown API. Optionally apply GitLab Flavored Markdown and resolve references within a project's context. Returns: the rendered HTML string. See also: repository.file_get, wiki.get.

**Parámetros obligatorios:** `text (string)`

### `repository.merge_base` — Repository Merge Base

_solo lectura_

Find the common ancestor (merge base) of two or more refs. Returns: the merge-base commit with metadata and web URL. See also: repository.compare, branch.list.

**Parámetros obligatorios:** `project_id (string)`, `refs (array)`

### `repository.raw_blob` — Repository Raw Blob

_solo lectura_

Get the raw content of a git blob by SHA. Returns: blob SHA, byte size, decoded text content (or image data), and a content category (text/image/binary). See also: repository.blob, repository.tree.

**Parámetros obligatorios:** `project_id (string)`, `sha (string)`

### `repository.read_submodule_file` — Read Repository Submodule File

_solo lectura_

Read a file from inside a submodule at the parent-pinned commit. Returns: file_name, file_path, submodule_path, resolved_project, commit_sha, size, decoded content, and encoding. See also: repository.list_submodules, repository.file_get, repository.update_submodule.

**Parámetros obligatorios:** `file_path (string)`, `project_id (string)`, `submodule_path (string)`

### `repository.tree` — Repository Tree

_solo lectura_

List repository tree items. Returns: paths, object IDs, entry types (blob/tree), and pagination metadata. See also: repository.blob, repository.raw_blob, branch.list.

**Parámetros obligatorios:** `project_id (string)`

### `repository.update_submodule` — Update Repository Submodule

Update a submodule pointer to a new commit SHA on a branch. Returns: the created commit with id, short_id, title, author and committer details, dates, parent_ids, message, and web_url. See also: repository.list_submodules, repository.read_submodule_file, repository.commit_get.

**Parámetros obligatorios:** `branch (string)`, `commit_sha (string)`, `project_id (string)`, `submodule (string)`