Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"packages/gitlab-mcp": "10.1.0",
"packages/gitlab-mcp-db": "10.1.0"
"packages/gitlab-mcp": "10.2.0",
"packages/gitlab-mcp-db": "10.2.0"
}
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

[![npm version](https://img.shields.io/npm/v/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![npm downloads](https://img.shields.io/npm/dm/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE) [![Release](https://github.com/structured-world/gitlab-mcp/workflows/Release/badge.svg)](https://github.com/structured-world/gitlab-mcp/actions) [![Coverage](https://codecov.io/gh/structured-world/gitlab-mcp/graph/badge.svg)](https://codecov.io/gh/structured-world/gitlab-mcp) [![Coverage Report](https://img.shields.io/badge/Coverage-Live%20Report-brightgreen?logo=github)](https://gitlab-mcp.sw.foundation/coverage/)

Advanced GitLab MCP server — 58 CQRS tools exposing 231 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.
Advanced GitLab MCP server — 59 CQRS tools exposing 231 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.

[![Install in Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Install_Extension-F97316?style=for-the-badge)](https://gitlab-mcp.sw.foundation/downloads/gitlab-mcp-10.1.0.mcpb)
[![Install in Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Install_Extension-F97316?style=for-the-badge)](https://gitlab-mcp.sw.foundation/downloads/gitlab-mcp-10.2.0.mcpb)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP_Server-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22gitlab-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40structured-world%2Fgitlab-mcp%22%5D%7D)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_MCP_Server-24bfa5?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode-insiders:mcp/install?%7B%22name%22%3A%22gitlab-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40structured-world%2Fgitlab-mcp%22%5D%7D)

Expand Down Expand Up @@ -36,7 +36,7 @@ This is a monorepo with two npm packages:

## Highlights

- **58 tools** across 26 entity types — projects, merge requests, pipelines, work items, wiki, and more
- **59 tools** across 26 entity types — projects, merge requests, pipelines, work items, wiki, and more
- **CQRS architecture** — `browse_*` for queries, `manage_*` for commands
- **Connection resilience** — Bounded startup, auto-reconnect with exponential backoff, disconnected mode when GitLab is unreachable
- **Multi-instance support** — Connect to GitLab.com, self-managed, and self-hosted instances with per-instance OAuth and rate limiting
Expand All @@ -51,7 +51,7 @@ This is a monorepo with two npm packages:

GitLab exposes hundreds of API operations. Giving each its own MCP tool floods an
agent's context; a thin API wrapper pushes that complexity back onto the agent. This
server takes a third path: 58 CQRS tools, each holding several typed
server takes a third path: 59 CQRS tools, each holding several typed
actions, expose 231 operations across 26 entity types.

- `browse_*` tools are read-only queries; `manage_*` tools are writes.
Expand All @@ -77,7 +77,7 @@ Full documentation is available at **[gitlab-mcp.sw.foundation](https://gitlab-m
| [Installation](https://gitlab-mcp.sw.foundation/guide/installation/npm) | npm, Docker, VS Code, Codex |
| [Configuration](https://gitlab-mcp.sw.foundation/guide/configuration) | Environment variables, feature flags |
| [Multi-Instance](https://gitlab-mcp.sw.foundation/guide/multi-instance) | Connect to multiple GitLab instances |
| [Tool Reference](https://gitlab-mcp.sw.foundation/tools/) | All 58 tools with parameters |
| [Tool Reference](https://gitlab-mcp.sw.foundation/tools/) | All 59 tools with parameters |
| [OAuth Setup](https://gitlab-mcp.sw.foundation/security/oauth) | Team authentication with Claude |
| [TLS/HTTPS](https://gitlab-mcp.sw.foundation/advanced/tls) | Production deployment with SSL |
| [Customization](https://gitlab-mcp.sw.foundation/advanced/customization) | Tool descriptions, action filtering |
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "gitlab-mcp-monorepo",
"version": "10.1.0",
"version": "10.2.0",
"private": true,
"description": "Monorepo root for @structured-world/gitlab-mcp and its optional packages",
"packageManager": "yarn@4.13.0",
Expand Down
15 changes: 15 additions & 0 deletions packages/gitlab-mcp-db/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,20 @@
# Changelog

## [10.2.0](https://github.com/structured-world/gitlab-mcp/compare/gitlab-mcp-db-v10.1.0...gitlab-mcp-db-v10.2.0) (2026-10-10)


### Features

* **mcp:** add Codex contracts and workflow skills ([#640](https://github.com/structured-world/gitlab-mcp/issues/640)) ([dada1b2](https://github.com/structured-world/gitlab-mcp/commit/dada1b2f5168d0cb044d5ef55c5b3bf854132b4e))
* **oauth:** complete Codex account linking and durable OAuth ([#656](https://github.com/structured-world/gitlab-mcp/issues/656)) ([f86ee6a](https://github.com/structured-world/gitlab-mcp/commit/f86ee6ae6a76ac6982b827dd1afb8f2dcbb063fe)), closes [#636](https://github.com/structured-world/gitlab-mcp/issues/636)


### Dependencies

* The following workspace dependencies were updated
* devDependencies
* @structured-world/gitlab-mcp bumped to 10.2.0

## [10.1.0](https://github.com/structured-world/gitlab-mcp/compare/gitlab-mcp-db-v10.0.1...gitlab-mcp-db-v10.1.0) (2026-10-08)


Expand Down
10 changes: 5 additions & 5 deletions packages/gitlab-mcp-db/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

[![npm version](https://img.shields.io/npm/v/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![npm downloads](https://img.shields.io/npm/dm/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/structured-world/gitlab-mcp/blob/HEAD/LICENSE) [![Release](https://github.com/structured-world/gitlab-mcp/workflows/Release/badge.svg)](https://github.com/structured-world/gitlab-mcp/actions) [![Coverage](https://codecov.io/gh/structured-world/gitlab-mcp/graph/badge.svg)](https://codecov.io/gh/structured-world/gitlab-mcp) [![Coverage Report](https://img.shields.io/badge/Coverage-Live%20Report-brightgreen?logo=github)](https://gitlab-mcp.sw.foundation/coverage/)

Advanced GitLab MCP server — 58 CQRS tools exposing 231 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.
Advanced GitLab MCP server — 59 CQRS tools exposing 231 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.

[![Install in Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Install_Extension-F97316?style=for-the-badge)](https://gitlab-mcp.sw.foundation/downloads/gitlab-mcp-10.1.0.mcpb)
[![Install in Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Install_Extension-F97316?style=for-the-badge)](https://gitlab-mcp.sw.foundation/downloads/gitlab-mcp-10.2.0.mcpb)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP_Server-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22gitlab-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40structured-world%2Fgitlab-mcp%22%5D%7D)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_MCP_Server-24bfa5?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode-insiders:mcp/install?%7B%22name%22%3A%22gitlab-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40structured-world%2Fgitlab-mcp%22%5D%7D)

Expand Down Expand Up @@ -36,7 +36,7 @@ This is a monorepo with two npm packages:

## Highlights

- **58 tools** across 26 entity types — projects, merge requests, pipelines, work items, wiki, and more
- **59 tools** across 26 entity types — projects, merge requests, pipelines, work items, wiki, and more
- **CQRS architecture** — `browse_*` for queries, `manage_*` for commands
- **Connection resilience** — Bounded startup, auto-reconnect with exponential backoff, disconnected mode when GitLab is unreachable
- **Multi-instance support** — Connect to GitLab.com, self-managed, and self-hosted instances with per-instance OAuth and rate limiting
Expand All @@ -51,7 +51,7 @@ This is a monorepo with two npm packages:

GitLab exposes hundreds of API operations. Giving each its own MCP tool floods an
agent's context; a thin API wrapper pushes that complexity back onto the agent. This
server takes a third path: 58 CQRS tools, each holding several typed
server takes a third path: 59 CQRS tools, each holding several typed
actions, expose 231 operations across 26 entity types.

- `browse_*` tools are read-only queries; `manage_*` tools are writes.
Expand All @@ -77,7 +77,7 @@ Full documentation is available at **[gitlab-mcp.sw.foundation](https://gitlab-m
| [Installation](https://gitlab-mcp.sw.foundation/guide/installation/npm) | npm, Docker, VS Code, Codex |
| [Configuration](https://gitlab-mcp.sw.foundation/guide/configuration) | Environment variables, feature flags |
| [Multi-Instance](https://gitlab-mcp.sw.foundation/guide/multi-instance) | Connect to multiple GitLab instances |
| [Tool Reference](https://gitlab-mcp.sw.foundation/tools/) | All 58 tools with parameters |
| [Tool Reference](https://gitlab-mcp.sw.foundation/tools/) | All 59 tools with parameters |
| [OAuth Setup](https://gitlab-mcp.sw.foundation/security/oauth) | Team authentication with Claude |
| [TLS/HTTPS](https://gitlab-mcp.sw.foundation/advanced/tls) | Production deployment with SSL |
| [Customization](https://gitlab-mcp.sw.foundation/advanced/customization) | Tool descriptions, action filtering |
Expand Down
2 changes: 1 addition & 1 deletion packages/gitlab-mcp-db/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@structured-world/gitlab-mcp-db",
"version": "10.1.0",
"version": "10.2.0",
"description": "Optional PostgreSQL/Prisma OAuth-storage backend for @structured-world/gitlab-mcp",
"license": "Apache-2.0",
"author": "Dmitry Prudnikov <mail@polaz.com>",
Expand Down
8 changes: 8 additions & 0 deletions packages/gitlab-mcp/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,14 @@

* exempt stdio session from idle timeout cleanup ([#363](https://github.com/structured-world/gitlab-mcp/issues/363)) ([ca563bd](https://github.com/structured-world/gitlab-mcp/commit/ca563bda9aa969d5d7680d3d89c2c72f32344838)), closes [#361](https://github.com/structured-world/gitlab-mcp/issues/361)

## [10.2.0](https://github.com/structured-world/gitlab-mcp/compare/gitlab-mcp-v10.1.0...gitlab-mcp-v10.2.0) (2026-10-10)


### Features

* **mcp:** add Codex contracts and workflow skills ([#640](https://github.com/structured-world/gitlab-mcp/issues/640)) ([dada1b2](https://github.com/structured-world/gitlab-mcp/commit/dada1b2f5168d0cb044d5ef55c5b3bf854132b4e))
* **oauth:** complete Codex account linking and durable OAuth ([#656](https://github.com/structured-world/gitlab-mcp/issues/656)) ([f86ee6a](https://github.com/structured-world/gitlab-mcp/commit/f86ee6ae6a76ac6982b827dd1afb8f2dcbb063fe)), closes [#636](https://github.com/structured-world/gitlab-mcp/issues/636)

## [10.1.0](https://github.com/structured-world/gitlab-mcp/compare/gitlab-mcp-v10.0.1...gitlab-mcp-v10.1.0) (2026-10-08)


Expand Down
10 changes: 5 additions & 5 deletions packages/gitlab-mcp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

[![npm version](https://img.shields.io/npm/v/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![npm downloads](https://img.shields.io/npm/dm/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/structured-world/gitlab-mcp/blob/HEAD/LICENSE) [![Release](https://github.com/structured-world/gitlab-mcp/workflows/Release/badge.svg)](https://github.com/structured-world/gitlab-mcp/actions) [![Coverage](https://codecov.io/gh/structured-world/gitlab-mcp/graph/badge.svg)](https://codecov.io/gh/structured-world/gitlab-mcp) [![Coverage Report](https://img.shields.io/badge/Coverage-Live%20Report-brightgreen?logo=github)](https://gitlab-mcp.sw.foundation/coverage/)

Advanced GitLab MCP server — 58 CQRS tools exposing 231 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.
Advanced GitLab MCP server — 59 CQRS tools exposing 231 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.

[![Install in Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Install_Extension-F97316?style=for-the-badge)](https://gitlab-mcp.sw.foundation/downloads/gitlab-mcp-10.1.0.mcpb)
[![Install in Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Install_Extension-F97316?style=for-the-badge)](https://gitlab-mcp.sw.foundation/downloads/gitlab-mcp-10.2.0.mcpb)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP_Server-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22gitlab-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40structured-world%2Fgitlab-mcp%22%5D%7D)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_MCP_Server-24bfa5?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode-insiders:mcp/install?%7B%22name%22%3A%22gitlab-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40structured-world%2Fgitlab-mcp%22%5D%7D)

Expand Down Expand Up @@ -36,7 +36,7 @@ This is a monorepo with two npm packages:

## Highlights

- **58 tools** across 26 entity types — projects, merge requests, pipelines, work items, wiki, and more
- **59 tools** across 26 entity types — projects, merge requests, pipelines, work items, wiki, and more
- **CQRS architecture** — `browse_*` for queries, `manage_*` for commands
- **Connection resilience** — Bounded startup, auto-reconnect with exponential backoff, disconnected mode when GitLab is unreachable
- **Multi-instance support** — Connect to GitLab.com, self-managed, and self-hosted instances with per-instance OAuth and rate limiting
Expand All @@ -51,7 +51,7 @@ This is a monorepo with two npm packages:

GitLab exposes hundreds of API operations. Giving each its own MCP tool floods an
agent's context; a thin API wrapper pushes that complexity back onto the agent. This
server takes a third path: 58 CQRS tools, each holding several typed
server takes a third path: 59 CQRS tools, each holding several typed
actions, expose 231 operations across 26 entity types.

- `browse_*` tools are read-only queries; `manage_*` tools are writes.
Expand All @@ -77,7 +77,7 @@ Full documentation is available at **[gitlab-mcp.sw.foundation](https://gitlab-m
| [Installation](https://gitlab-mcp.sw.foundation/guide/installation/npm) | npm, Docker, VS Code, Codex |
| [Configuration](https://gitlab-mcp.sw.foundation/guide/configuration) | Environment variables, feature flags |
| [Multi-Instance](https://gitlab-mcp.sw.foundation/guide/multi-instance) | Connect to multiple GitLab instances |
| [Tool Reference](https://gitlab-mcp.sw.foundation/tools/) | All 58 tools with parameters |
| [Tool Reference](https://gitlab-mcp.sw.foundation/tools/) | All 59 tools with parameters |
| [OAuth Setup](https://gitlab-mcp.sw.foundation/security/oauth) | Team authentication with Claude |
| [TLS/HTTPS](https://gitlab-mcp.sw.foundation/advanced/tls) | Production deployment with SSL |
| [Customization](https://gitlab-mcp.sw.foundation/advanced/customization) | Tool descriptions, action filtering |
Expand Down
11 changes: 9 additions & 2 deletions packages/gitlab-mcp/package.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
{
"name": "@structured-world/gitlab-mcp",
"mcpName": "io.github.structured-world/gitlab-mcp",
"version": "10.1.0",
"version": "10.2.0",
"description": "Advanced GitLab MCP server",
"mcp": {
"name": "GitLab MCP Server",
"description": "Advanced GitLab MCP server - 58 tools across 14 entity types with CQRS architecture, OAuth 2.1, and multiple transport modes",
"description": "Advanced GitLab MCP server - 59 tools across 15 entity types with CQRS architecture, OAuth 2.1, and multiple transport modes",
"repository": "https://github.com/structured-world/gitlab-mcp",
"homepage": "https://gitlab-mcp.sw.foundation",
"author": "Dmitry Prudnikov",
Expand Down Expand Up @@ -137,6 +137,13 @@
"tier": "free",
"readOnly": true
},
{
"name": "get_profile",
"description": "Identify the GitLab account this connection uses: a stable account id, display name, email when GitLab provides it, and the username with its instance.",
"category": "General",
"tier": "free",
"readOnly": false
},
{
"name": "browse_labels",
"description": "List and inspect project or group labels.",
Expand Down
6 changes: 3 additions & 3 deletions packages/gitlab-mcp/server.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,19 +3,19 @@
"$comment": "Schema version 2025-12-11 is the current MCP Registry standard. Only essential env vars are exposed here; USE_* feature flags are documented at websiteUrl and available via MCPB toggles.",
"name": "io.github.structured-world/gitlab-mcp",
"title": "Advanced GitLab MCP server",
"description": "58 CQRS tools exposing 231 GitLab operations across 26 entity types",
"description": "59 CQRS tools exposing 231 GitLab operations across 26 entity types",
"websiteUrl": "https://gitlab-mcp.sw.foundation",
"repository": {
"url": "https://github.com/structured-world/gitlab-mcp",
"source": "github"
},
"version": "10.1.0",
"version": "10.2.0",
"_versionNote": "Updated dynamically by prepare-release.sh during semantic-release",
"packages": [
{
"registryType": "npm",
"identifier": "@structured-world/gitlab-mcp",
"version": "10.1.0",
"version": "10.2.0",
"transport": {
"type": "stdio"
},
Expand Down
Loading