How do I install the shift mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `MCP_TRANSPORT_TYPE`, `MCP_HTTP_HOST` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Shift MCP Server

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

Local serverstdio

What is the Shift MCP Server?

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

What the server does

Declarative tool definitions — single file per tool, framework handles registration and validation
Unified error handling across all tools
Structured logging with request-scoped context
Runs locally (stdio/HTTP) from the same codebase
In-memory worker session store — no database, no filesystem writes, clears on restart
Coordination protocol injected on every check-in so agents know how to behave

Credentials and setup notes

Bun v1.2.0 or higher

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
shift_check_in	Register or update a worker session. Returns worker ID, coordination instructions, and active peers.
shift_check_out	End a working session. Removes from active worker list.

How to install the Shift MCP Server

{
  "mcpServers": {
    "shift": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/shift-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Bun v1.2.0 or higher

Variable	Description	Required
MCP_TRANSPORT_TYPE	Configuration value read at startup.	Optional
MCP_HTTP_HOST	Endpoint or connection string the server talks to.	Optional

Example prompts to try

“Use Shift to shift check in.”
“Use Shift to shift check out.”
“Use Shift to Prerequisites.”

Frequently asked questions

Lightweight coordination layer for multiple AI agents working on the same codebase simultaneously. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.