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)

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.