Skip to content
MCP server

Shift MCP Server

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

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.2.0
Listing updated
5 days ago

About Shift MCP Server

Shift MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

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

Install

Run in a terminal

claude mcp add shift-mcp-server -- npx -y @cyanheads/shift-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "shift-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/shift-mcp-server"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "shift-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/shift-mcp-server"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "shift-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/shift-mcp-server"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "shift-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/shift-mcp-server"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "shift-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/shift-mcp-server"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SHIFT_WORKSPACEShared exact-match workspace namespace; defaults to the launch Git root or cwd.
  • SHIFT_STATE_DIRShared writable SQLite directory; defaults to ~/.local/state/shift-mcp-server.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • SHIFT_WORKSPACEDefault exact-match namespace. Multiplexed HTTP callers must select workspace per tool call.
  • SHIFT_STATE_DIRShared writable SQLite directory; defaults to ~/.local/state/shift-mcp-server.
  • MCP_TRANSPORT_TYPESelects the HTTP transport.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_SESSION_MODESession handling for the HTTP transport: 'auto', 'stateful', or 'stateless'.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Pricing

Open source

Shift MCP Server FAQ

Is Shift MCP Server free?

Yes. Shift MCP Server is open source, so you can use and self-host it for free.

How do I add Shift MCP Server to Claude Code?

Run this command in your terminal: claude mcp add shift-mcp-server -- npx -y @cyanheads/shift-mcp-server

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers