GitLab · OpenAPI Overlay 1.0.0

API Evangelist MCP tool bindings for the GitLab REST API

68 actions 68 updates update extends openapi/gitlab-rest-api-openapi.yml
Derived by API Evangelist Built from the contracts GitLab publishes. GitLab did not publish this file.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-mcp-toolsx-mcp-server

Targets 68 · first 16 shown; the file carries all of them

$.info
$.paths['/api/v4/projects/{id}/pipelines/{pipeline_id}'].delete
$.paths['/api/v4/groups'].get
$.paths['/api/v4/groups/{id}/labels'].get
$.paths['/api/v4/groups/{id}/projects'].get
$.paths['/api/v4/groups/{id}/wikis'].get
$.paths['/api/v4/projects'].get
$.paths['/api/v4/projects/{id}'].get
$.paths['/api/v4/projects/{id}/issues/{issue_iid}'].get
$.paths['/api/v4/projects/{id}/jobs/{job_id}'].get
$.paths['/api/v4/projects/{id}/jobs/{job_id}/artifacts'].get
$.paths['/api/v4/projects/{id}/jobs/{job_id}/trace'].get
$.paths['/api/v4/projects/{id}/labels'].get
$.paths['/api/v4/projects/{id}/members'].get
$.paths['/api/v4/projects/{id}/members/all'].get
$.paths['/api/v4/projects/{id}/merge_requests'].get

OpenAPI Overlay

Raw ↑ 
# Generated by API Evangelist from mcp/gitlab-tool-crosswalk.yml. Bindings are derived, not published by GitLab.
overlay: 1.0.0
info:
  title: API Evangelist MCP tool bindings for the GitLab REST API
  version: 1.0.0
extends: openapi/gitlab-rest-api-openapi.yml
x-provenance:
  method: derived
  generated: '2026-11-05'
  source: mcp/gitlab-tool-crosswalk.yml (documented GitLab MCP tools bound by name/semantics; not confirmed by GitLab)
actions:
- target: $.info
  update:
    x-mcp-server:
      endpoint: https://gitlab.com/api/v4/mcp
      docs: https://docs.gitlab.com/user/model_context_protocol/mcp_server_tools/
      auth: OAuth 2.0 (scope mcp) or personal access token
      crosswalk: mcp/gitlab-tool-crosswalk.yml
      method: derived
      generated: '2026-11-05'
- target: $.paths['/api/v4/projects/{id}/pipelines/{pipeline_id}'].delete
  update:
    x-mcp-tools:
    - tool: manage_pipeline
      toolset: ci
      confidence: medium
- target: $.paths['/api/v4/groups'].get
  update:
    x-mcp-tools:
    - tool: list_groups
      toolset: core
      confidence: medium
- target: $.paths['/api/v4/groups/{id}/labels'].get
  update:
    x-mcp-tools:
    - tool: search_labels
      toolset: core
      confidence: medium
- target: $.paths['/api/v4/groups/{id}/projects'].get
  update:
    x-mcp-tools:
    - tool: list_projects
      toolset: core
      confidence: medium
- target: $.paths['/api/v4/groups/{id}/wikis'].get
  update:
    x-mcp-tools:
    - tool: list_wiki_pages
      toolset: wikis
      confidence: high
- target: $.paths['/api/v4/projects'].get
  update:
    x-mcp-tools:
    - tool: list_projects
      toolset: core
      confidence: medium
- target: $.paths['/api/v4/projects/{id}'].get
  update:
    x-mcp-tools:
    - tool: get_project
      toolset: core
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/issues/{issue_iid}'].get
  update:
    x-mcp-tools:
    - tool: get_issue
      toolset: work_items
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/jobs/{job_id}'].get
  update:
    x-mcp-tools:
    - tool: get_job
      toolset: ci
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/jobs/{job_id}/artifacts'].get
  update:
    x-mcp-tools:
    - tool: get_artifact_file
      toolset: ci
      confidence: low
- target: $.paths['/api/v4/projects/{id}/jobs/{job_id}/trace'].get
  update:
    x-mcp-tools:
    - tool: get_job
      toolset: ci
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/labels'].get
  update:
    x-mcp-tools:
    - tool: search_labels
      toolset: core
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/members'].get
  update:
    x-mcp-tools:
    - tool: list_project_members
      toolset: core
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/members/all'].get
  update:
    x-mcp-tools:
    - tool: list_project_members
      toolset: core
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/merge_requests'].get
  update:
    x-mcp-tools:
    - tool: list_merge_requests
      toolset: merge_requests
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/merge_requests/{merge_request_iid}'].get
  update:
    x-mcp-tools:
    - tool: get_merge_request
      toolset: merge_requests
      confidence: low
- target: $.paths['/api/v4/projects/{id}/merge_requests/{merge_request_iid}/commits'].get
  update:
    x-mcp-tools:
    - tool: get_merge_request
      toolset: merge_requests
      confidence: low
    - tool: get_merge_request_commits
      toolset: merge_requests
      confidence: high
- target: $.paths['/api/v4/projects/{id}/merge_requests/{merge_request_iid}/diffs'].get
  update:
    x-mcp-tools:
    - tool: get_merge_request
      toolset: merge_requests
      confidence: low
    - tool: get_merge_request_diffs
      toolset: merge_requests
      confidence: high
- target: $.paths['/api/v4/projects/{id}/merge_requests/{merge_request_iid}/pipelines'].get
  update:
    x-mcp-tools:
    - tool: get_merge_request
      toolset: merge_requests
      confidence: low
    - tool: get_merge_request_pipelines
      toolset: merge_requests
      confidence: high
- target: $.paths['/api/v4/projects/{id}/merge_requests/{noteable_id}/discussions'].get
  update:
    x-mcp-tools:
    - tool: get_merge_request
      toolset: merge_requests
      confidence: low
- target: $.paths['/api/v4/projects/{id}/merge_requests/{noteable_id}/notes'].get
  update:
    x-mcp-tools:
    - tool: get_merge_request
      toolset: merge_requests
      confidence: low
    - tool: get_merge_request_notes
      toolset: merge_requests
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/pipelines'].get
  update:
    x-mcp-tools:
    - tool: list_pipelines
      toolset: ci
      confidence: high
- target: $.paths['/api/v4/projects/{id}/pipelines/{pipeline_id}'].get
  update:
    x-mcp-tools:
    - tool: get_pipeline
      toolset: ci
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/pipelines/{pipeline_id}/bridges'].get
  update:
    x-mcp-tools:
    - tool: get_pipeline
      toolset: ci
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/pipelines/{pipeline_id}/jobs'].get
  update:
    x-mcp-tools:
    - tool: get_pipeline
      toolset: ci
      confidence: medium
    - tool: get_pipeline_jobs
      toolset: ci
      confidence: high
- target: $.paths['/api/v4/projects/{id}/releases'].get
  update:
    x-mcp-tools:
    - tool: list_releases
      toolset: repository
      confidence: high
- target: $.paths['/api/v4/projects/{id}/repository/branches'].get
  update:
    x-mcp-tools:
    - tool: list_branches
      toolset: repository
      confidence: high
- target: $.paths['/api/v4/projects/{id}/repository/commits'].get
  update:
    x-mcp-tools:
    - tool: list_commits
      toolset: repository
      confidence: high
- target: $.paths['/api/v4/projects/{id}/repository/commits/{sha}'].get
  update:
    x-mcp-tools:
    - tool: get_commit
      toolset: repository
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/repository/commits/{sha}/comments'].get
  update:
    x-mcp-tools:
    - tool: get_commit
      toolset: repository
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/repository/commits/{sha}/diff'].get
  update:
    x-mcp-tools:
    - tool: get_commit
      toolset: repository
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/repository/files/{file_path}'].get
  update:
    x-mcp-tools:
    - tool: get_repository_file
      toolset: repository
      confidence: high
- target: $.paths['/api/v4/projects/{id}/repository/files/{file_path}/raw'].get
  update:
    x-mcp-tools:
    - tool: get_repository_file
      toolset: repository
      confidence: high
- target: $.paths['/api/v4/projects/{id}/repository/tags'].get
  update:
    x-mcp-tools:
    - tool: list_tags
      toolset: repository
      confidence: high
- target: $.paths['/api/v4/projects/{id}/repository/tree'].get
  update:
    x-mcp-tools:
    - tool: list_repository_tree
      toolset: repository
      confidence: high
- target: $.paths['/api/v4/projects/{id}/vulnerabilities'].get
  update:
    x-mcp-tools:
    - tool: list_vulnerabilities
      toolset: code_security
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/wikis'].get
  update:
    x-mcp-tools:
    - tool: list_wiki_pages
      toolset: wikis
      confidence: high
- target: $.paths['/api/v4/search'].get
  update:
    x-mcp-tools:
    - tool: search
      toolset: core
      confidence: high
- target: $.paths['/api/v4/todos'].get
  update:
    x-mcp-tools:
    - tool: list_todos
      toolset: core
      confidence: high
- target: $.paths['/api/v4/users'].get
  update:
    x-mcp-tools:
    - tool: get_user
      toolset: core
      confidence: medium
- target: $.paths['/api/v4/users/{id}'].get
  update:
    x-mcp-tools:
    - tool: get_user
      toolset: core
      confidence: medium
- target: $.paths['/api/v4/vulnerabilities/{id}'].get
  update:
    x-mcp-tools:
    - tool: get_vulnerability
      toolset: code_security
      confidence: medium
- target: $.paths['/api/v4/projects'].post
  update:
    x-mcp-tools:
    - tool: save_project
      toolset: core
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/fork'].post
  update:
    x-mcp-tools:
    - tool: fork_repository
      toolset: repository
      confidence: high
- target: $.paths['/api/v4/projects/{id}/issues'].post
  update:
    x-mcp-tools:
    - tool: create_issue
      toolset: work_items
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/issues/{issue_iid}/links'].post
  update:
    x-mcp-tools:
    - tool: link_work_items
      toolset: work_items
      confidence: low
- target: $.paths['/api/v4/projects/{id}/issues/{noteable_id}/notes'].post
  update:
    x-mcp-tools:
    - tool: save_note
      toolset: core
      confidence: low
- target: $.paths['/api/v4/projects/{id}/merge_requests'].post
  update:
    x-mcp-tools:
    - tool: save_merge_request
      toolset: merge_requests
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/merge_requests/{merge_request_iid}/approve'].post
  update:
    x-mcp-tools:
    - tool: save_merge_request_review
      toolset: merge_requests
      confidence: low
- target: $.paths['/api/v4/projects/{id}/merge_requests/{merge_request_iid}/draft_notes'].post
  update:
    x-mcp-tools:
    - tool: save_merge_request_review
      toolset: merge_requests
      confidence: low
- target: $.paths['/api/v4/projects/{id}/merge_requests/{merge_request_iid}/draft_notes/bulk_publish'].post
  update:
    x-mcp-tools:
    - tool: save_merge_request_review
      toolset: merge_requests
      confidence: low
- target: $.paths['/api/v4/projects/{id}/merge_requests/{noteable_id}/discussions/{discussion_id}/notes'].post
  update:
    x-mcp-tools:
    - tool: save_note
      toolset: core
      confidence: low
- target: $.paths['/api/v4/projects/{id}/merge_requests/{noteable_id}/notes'].post
  update:
    x-mcp-tools:
    - tool: save_note
      toolset: core
      confidence: low
- target: $.paths['/api/v4/projects/{id}/pipeline'].post
  update:
    x-mcp-tools:
    - tool: save_pipeline
      toolset: ci
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/pipelines/{pipeline_id}/cancel'].post
  update:
    x-mcp-tools:
    - tool: save_pipeline
      toolset: ci
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/pipelines/{pipeline_id}/retry'].post
  update:
    x-mcp-tools:
    - tool: save_pipeline
      toolset: ci
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/repository/branches'].post
  update:
    x-mcp-tools:
    - tool: add_branch
      toolset: repository
      confidence: high
- target: $.paths['/api/v4/projects/{id}/repository/commits'].post
  update:
    x-mcp-tools:
    - tool: add_commit
      toolset: repository
      confidence: high
- target: $.paths['/api/v4/vulnerabilities/{id}/confirm'].post
  update:
    x-mcp-tools:
    - tool: save_vulnerability
      toolset: code_security
      confidence: low
- target: $.paths['/api/v4/vulnerabilities/{id}/dismiss'].post
  update:
    x-mcp-tools:
    - tool: save_vulnerability
      toolset: code_security
      confidence: low
- target: $.paths['/api/v4/vulnerabilities/{id}/issue_links'].post
  update:
    x-mcp-tools:
    - tool: save_vulnerability
      toolset: code_security
      confidence: low
- target: $.paths['/api/v4/vulnerabilities/{id}/resolve'].post
  update:
    x-mcp-tools:
    - tool: save_vulnerability
      toolset: code_security
      confidence: low
- target: $.paths['/api/v4/vulnerabilities/{id}/revert'].post
  update:
    x-mcp-tools:
    - tool: save_vulnerability
      toolset: code_security
      confidence: low
- target: $.paths['/api/v4/projects/{id}'].put
  update:
    x-mcp-tools:
    - tool: save_project
      toolset: core
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/merge_requests/{merge_request_iid}'].put
  update:
    x-mcp-tools:
    - tool: save_merge_request
      toolset: merge_requests
      confidence: medium
- target: $.paths['/api/v4/projects/{id}/merge_requests/{merge_request_iid}/merge'].put
  update:
    x-mcp-tools:
    - tool: accept_merge_request
      toolset: merge_requests
      confidence: high
- target: $.paths['/api/v4/projects/{id}/pipelines/{pipeline_id}/metadata'].put
  update:
    x-mcp-tools:
    - tool: save_pipeline
      toolset: ci
      confidence: medium
    - tool: manage_pipeline
      toolset: ci
      confidence: medium

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay 
curl "https://apis.io/api/v1/overlays/gitlab-rest-api-mcp-overlay"
All openapi overlays 
curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.