cyanheads avatar

Shift Mcp Server

cyanheads/shift-mcp-server

Solves the "multiple AI agents editing the same codebase" problem with two simple tools: check in with your worker ID and a gist of what you're doing, get back a coordination protocol plus a live table of who else is active and which files they've claimed. Check out when you're done. The shift://status resource shows the full worker roster. Everything's in-memory, so state clears on restart, which is actually the point: lightweight session coordination without persistence overhead. Built for Claude Desktop or any MCP client that needs to prevent agents from stomping on each other's work during parallel code modifications.

GitHub stars
1
tools
2
transport
STDIO, HTTP
env vars
9
last updated
Oct 17, 2026

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

shift_check_inRegister or update a worker session. Returns a worker ID, the coordination protocol, and the active peers.

Register or update a worker session. Returns a worker ID, the coordination protocol, and the active peers.

No parameter schema in public metadata yet.

shift_check_outEnd a working session and remove it from the active worker list.

End a working session and remove it from the active worker list.

No parameter schema in public metadata yet.

Sponsors

Configuration

SHIFT_WORKSPACE

Shared exact-match workspace namespace; defaults to the launch Git root or cwd.

SHIFT_STATE_DIR

Shared writable SQLite directory; defaults to ~/.local/state/shift-mcp-server.

MCP_LOG_LEVELdefault: info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

MCP_TRANSPORT_TYPEdefault: http

Selects the HTTP transport.

MCP_HTTP_HOSTdefault: 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault: 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault: /mcp

The endpoint path for the MCP server.

MCP_SESSION_MODEdefault: stateless

Session handling for the HTTP transport: 'auto', 'stateful', or 'stateless'.

MCP_AUTH_MODEdefault: none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

Readme

@cyanheads/shift-mcp-server

Lightweight coordination layer for multiple AI agents working on the same codebase simultaneously.

2 Tools • 1 Resource • 1 Resource Template

Version License MCP SDK npm TypeScript Bun

Details

Repository
github.com/cyanheads/shift-mcp-server
Package
@cyanheads/shift-mcp-server
Transport
STDIO, HTTP
Registry
MCP registry, active

More from cyanheads