gitlab-mcpl
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GITLAB_URL | Yes | Required HTTPS origin/base path; /api/v4 is appended. No credentials, query or fragment. | |
| GITLAB_CA_FILE | No | Optional PEM trust bundle for this connection, replacing default roots. Otherwise Node default trust applies. | |
| GITLAB_PROJECTS | Yes | Required write/event allow-list, no globs/groups. Exactly * opts in to all-projects mode, which widens events only. | |
| GITLAB_LOG_LEVEL | No | Log level: debug, info, warn, error; stderr only. | info |
| GITLAB_ALLOW_HTTP | No | Explicit lab-only HTTP exception. Defaults to false. | false |
| GITLAB_READ_ALLOW | No | Same as projects: exact path/id, group/* including subgroups, or *. No default with GITLAB_PROJECTS=*; it must be set explicitly. | |
| GITLAB_STATE_FILE | No | Unset means in memory; strongly recommended to set for restart continuity. | |
| GITLAB_TOKEN_FILE | Yes | Required regular mode-600 PAT file; whitespace-only or embedded-whitespace tokens are refused. | |
| GITLAB_TOOLS_DENY | No | Removes named tools, also from channel publication routes. | |
| GITLAB_MAINTAINERS | No | Comma-separated usernames; optional maintainer tag only, not authority. | |
| GITLAB_WRITE_ALLOW | No | Only valid with GITLAB_PROJECTS=*, where it is the only write authority and is required for every write feature set. Exact path, numeric id, or group/*; a bare * is refused. | |
| GITLAB_BRANCH_WATCH | No | Comma-separated project:branch entries with exact branch names. | |
| GITLAB_FEATURE_SETS | No | Comma-separated feature sets. Defaults to gitlab.events,gitlab.read. | gitlab.events,gitlab.read |
| GITLAB_SYSTEM_NOTES | No | Whether to drop or keep system notes; values are drop or keep. | drop |
| NODE_EXTRA_CA_CERTS | No | Can extend Node default CA trust at process startup when GITLAB_CA_FILE is unset. | |
| GITLAB_CI_RETRY_REFS | No | Retained for compatibility, but CI retry tools currently fail closed regardless of this value. | |
| GITLAB_EVENT_SOURCES | No | Comma-separated event sources; also supports reviewing, branches, threads. | todos,own-mrs,pipelines |
| GITLAB_MCPL_ENV_FILE | No | Used by the Bash launcher deploy/gitlab-mcpl. It sources this operator-owned file; use shell quoting there, not systemd EnvironmentFile syntax. | $HOME/.config/gitlab-mcpl/env |
| GITLAB_PIPELINE_REFS | No | Comma-separated exact refs, e.g. main. | |
| GITLAB_DIFF_MAX_BYTES | No | Total diff text byte limit. | 200000 |
| GITLAB_FILE_MAX_BYTES | No | File content byte limit; UTF-8 content with truncation flag. | 200000 |
| GITLAB_MR_FORCE_DRAFT | No | When true, create/title edits retain Draft and draft=false is refused. | false |
| GITLAB_PIPELINE_SCOPE | No | Pipeline scope; also supports users, refs. | own-mrs,own-merges |
| GITLAB_PIPELINE_USERS | No | Comma-separated usernames of triggering users, e.g. a project-token account. | |
| GITLAB_EXPECT_USERNAME | No | Optional startup identity check. | |
| GITLAB_HTTP_TIMEOUT_MS | No | Whole request timeout in milliseconds, 1–300000, including streamed trace. | 30000 |
| GITLAB_MR_TARGET_ALLOW | No | Empty means cannot create/retarget any MR. | |
| GITLAB_POLL_OVERLAP_MS | No | Polling overlap window in milliseconds; 1000–3600000. | 120000 |
| GITLAB_POLL_INTERVAL_MS | No | Polling interval in milliseconds; 30000–3600000, never zero in this polling-only release. | 60000 |
| GITLAB_PROJECTS_EXCLUDE | No | Only valid with GITLAB_PROJECTS=*. Exact path, numeric id, or group/* including subgroups. | |
| GITLAB_JOB_EVENT_PATTERN | No | Comma-separated * job-name globs. | |
| GITLAB_JOB_LOG_MAX_BYTES | No | Tail bytes for job logs; per-call smaller maximum allowed. | 65536 |
| GITLAB_MERGE_AUTHOR_ONLY | No | Merge author restriction. Defaults to true. | true |
| GITLAB_MR_SOURCE_PATTERN | No | Empty means any branch not in target allow-list. Otherwise a * glob. | |
| GITLAB_PIPELINE_PROJECTS | No | Same as projects and must be a subset. With GITLAB_PROJECTS=*, empty and required for users/refs scope. | |
| GITLAB_PIPELINE_STATUSES | No | Allowed final pipeline statuses: success, failed, canceled, skipped. | failed,success |
| GITLAB_SEARCH_FANOUT_MAX | No | Group search fanout maximum, range 1–30. | 10 |
| GITLAB_JOB_EVENT_STATUSES | No | Job event final-status vocabulary: success, failed, canceled, skipped. | failed |
| GITLAB_MERGE_TARGET_ALLOW | No | Required when the merge set is declared. | |
| GITLAB_DIFF_FILE_MAX_BYTES | No | Per-file diff byte limit; cut files are listed. | 40000 |
| GITLAB_OWN_MERGE_WINDOW_MS | No | Own-merge memory window in milliseconds; maximum 7 days. | 21600000 |
| GITLAB_HOT_POLL_INTERVAL_MS | No | Hot polling interval in milliseconds; minimum 10000, 0 disables hot polling. | 20000 |
| GITLAB_MERGE_REQUIRE_PIPELINE | No | Requires a successful pipeline for exactly the head SHA. Defaults to true. | true |
| GITLAB_PIPELINE_EVENT_LOG_BYTES | No | Failed-job log tail bytes. Defaults to 0 (off); examples use 4096. Maximum 65536 useful-text bytes per failed job, at most three jobs. | 0 |
| GITLAB_MERGE_REMOVE_SOURCE_BRANCH | No | Whether merge should remove the source branch. Defaults to false. | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues