mcpbeat Sign in

Session Relay MCP Server

local only

Session Relay runs on your own machine — the client starts it, so there is no endpoint to ping. Last commit 24 Oct 2026.

Share coding-agent sessions with your team: /share in one agent, /pickup in another.

—
Installs / week
npm · session-relay
4
Stars
0 open issues
24 Oct 2026
Last commit
9 releases in 90 days
AGPL-3.0
License
TypeScript

What the code does

We read the source, 3 h ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command packages/cli/src/commands/login.ts:17
    spawn(cmd, args, { stdio: "ignore", detached: true }).on("error", () => undefined).unref();
Builds a database query by concatenation packages/server/src/routes/sessions.ts:211
        ${file ? sql`AND EXISTS (SELECT 1 FROM unnest(s.files_touched) f WHERE f ILIKE ${"%" + file.replace(/[\\%_]/g, (ch) => "\\" + ch) + "%"})` : sql``}

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add session-relay -- npx -y session-relay
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "session-relay": {
      "command": "npx",
      "args": [
        "-y",
        "session-relay"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.session-relay]
command = "npx"
args = ["-y", "session-relay"]
.cursor/mcp.json
{
  "mcpServers": {
    "session-relay": {
      "command": "npx",
      "args": [
        "-y",
        "session-relay"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "session-relay": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "session-relay"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: RELAY_SERVER (URL of your team's Session Relay server. Optional if you ran relay login), RELAY_TOKEN (Personal access token (srk_...) from Settings → Tokens. Optional if you ran relay login).

Alternatives to Session Relay

same job, measured the same way
Sshboard
by meta-taro

An AI agent reads your server over the one SSH session you are already watching.

local only
Emulo
by ohad6k

Mine your AI coding session logs into a you.md profile with dated receipts, for an agent to read.

237 installs/wk local only
TeamShared
by xhad

Shared memory for coding agents. Stop re-explaining your codebase every session.

92 tools answering
Aethereum
by br9704

The team layer for AI coding agents: shared contracts, collision alerts, E2EE sessions.

52 installs/wk answering
Vibeshare Live
by pooriaarab

Share a live agent coding session by URL. Spectate or invite in.

55 installs/wk local only
Coordigent
by coordigent

Coding agents in one repo see each other, get warned before shared edits, and message.

431 installs/wk answering
Vibsync
by vibsync

One shared brain for your AI coding agents: team memory, agent Q&A, tasks, and file claims.

answering
Swarmail
by bompus

Local mail between coding-agent sessions on one machine; relays to a running Swarmail server.

275 installs/wk local only

Session Relay — questions

Answers built from our own checks of this server.

Why is there no uptime for Session Relay?
Session Relay runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package session-relay.
How do I connect Session Relay?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls session-relay straight from npm; nothing to host, nothing to sign up for.
Is Session Relay open source?
Yes — it is published under the AGPL-3.0 licence, written in TypeScript and 4 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.