Skip to main content
Glama

Space MCP

MCP server and CLI for JetBrains Space merge requests and Patronus CI dry runs.

Installation

Install uv, then:

uv tool install git+https://github.com/bindreams/space-mcp.git

This installs two entry points:

Command

Purpose

space

CLI for merge requests, CI runs, and auth

space-mcp

MCP server (stdio transport)

Related MCP server: forgejo-mcp

Authentication

A JetBrains Space personal token is required. Generate one at Personal Tokens.

Token is resolved in order:

  1. SPACE_TOKEN environment variable

  2. OS keyring (stored via space auth login)

  3. ~/.config/space/credentials.json (plaintext fallback)

space auth login              # store token in keyring (prompted)
space auth login --token PAT  # non-interactive
space auth status             # show token source and detected context
space auth logout             # remove stored credentials

During login you will also be offered to authenticate Docker with registry.jetbrains.team.

MCP Tools

Tool

Description

Parameters

get_merge_request

Get MR details (title, state, author, reviewers)

project, repository, review_id

get_merge_requests

List MRs for a repository

project, repository, branch?, state?, limit?

get_merge_request_timeline

Full MR timeline: comments, reviews, dry run results

project, repository, review_id

put_merge_request

Create a new merge request

project, repository, source_branch, target_branch, title, description?

post_close_merge_request

Close a merge request

project, review_id

post_reopen_merge_request

Reopen a closed merge request

project, review_id

get_attachment

Download a file attachment from MR discussion

attachment_id

get_patronus_runs

List Patronus runs (dry runs / safe merges) for an MR

project, review_id

get_patronus_run

Run details with TeamCity checks and problems

run_id

put_patronus_dry_run

Start a CI dry run for an MR

project, review_id

post_cancel_patronus_run

Cancel a running Patronus run

run_id

Most tools return YAML; timeline returns Markdown. Parameters marked with ? are optional.

MCP server configuration

First, authenticate via the CLI — the MCP server picks up stored credentials automatically:

space auth login

Then add to .mcp.json (project) or ~/.claude.json (global):

{
  "mcpServers": {
    "space": {
      "command": "space-mcp"
    }
  }
}

CLI

Global options: -P/--project, -R/--repo, --json, --no-color. Project and repo are auto-detected from the git remote when inside a Space repository.

space mr — Merge requests

space mr view [REF]        # MR details (number, URL, branch, or current branch)
space mr list              # list MRs (-s open|closed|merged|all, -A author, -H branch)
space mr create BRANCH     # create MR from branch (-t title, -b base, -d description)
space mr close [REF]       # close an MR
space mr reopen [REF]      # reopen a closed MR
space mr timeline [REF]    # full timeline with discussions and dry run results
space mr checks [REF]      # Patronus CI check status (--watch to poll)
space mr diff [REF]        # diff between target and source (--stat, --name-only)
space mr checkout [REF]    # fetch and checkout the MR branch
space mr merge [REF]       # safe merge via Patronus (--rebase, --squash, --dry-run)
space mr download ID       # download attachment by ID (-o output path)

space run — Patronus CI runs

space run list            # list runs for current branch (-b branch, -B base)
space run view RUN        # run details with TeamCity checks (UUID or URL)
space run start [REF]     # start dry run (--merge, --rebase, --squash, --watch)
space run cancel RUN      # cancel a running Patronus run
space run watch RUN       # live progress with terminal animation

space auth — Authentication

space auth login          # store token (--token, --insecure-storage)
space auth logout         # remove credentials
space auth status         # show token source and context

space api — Raw API access

space api /api/http/...                   # authenticated GET to Space
space api /app/rest/... --patronus        # authenticated GET to Patronus
space api /api/http/... -X POST -f key=val  # POST with JSON body

space status — Dashboard

space status              # MR and latest CI run for current branch

Development

See CONTRIBUTING.md for development setup and testing.

License

Copyright 2026, Anna Zhukova

This project is licensed under MPL-2.0. The license text can be found at LICENSE.md.

F
license - not found
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bindreams/space-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server