How do I install Handoff?

Handoff is a remote plugin. You do not need to install anything locally. Add the server URL to your AI app's MCP configuration and you are ready to go.

Is Handoff safe to use?

Yes. Handoff passed MCP Marketplace's automated security scan with a score of 10/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What AI apps work with Handoff?

Handoff uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Handoff MCP Server

by Josephibra

Developer ToolsLow Risk10.0MCP RegistryRemote

Free

Server data from the Official MCP Registry

Durable agent-to-agent handoffs and shared scratchpad for multi-agent workflows.

About

Durable agent-to-agent handoffs and shared scratchpad for multi-agent workflows.

Remote endpoints: streamable-http: https://handoff-mcp-server-production.mcp.xpay.sh/mcp streamable-http: https://handoff-mcp-server-production.up.railway.app/mcp

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (1 strong, 0 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

Endpoint verified · Requires authentication · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-josephibra-handoff-mcp-server": {
      "url": "https://handoff-mcp-server-production.mcp.xpay.sh/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

handoff-mcp-server

Durable handoffs and shared scratchpad for multi-agent workflows over MCP (HTTP transport).

Endpoints

GET / basic service info
GET /health health and storage stats
POST /mcp JSON-RPC MCP endpoint
GET /robots.txt discovery file
GET /llms.txt discovery file
GET /sitemap.xml discovery file

Environment Variables

PORT default 3000
DATA_DIR default /data
MCP_API_KEY required in production (NODE_ENV=production)
PUBLIC_MCP_DISCOVERY default true
PUBLIC_BASE_URL optional, used for absolute links in discovery files

Local Run

npm ci
npm run build
MCP_API_KEY=test-secret node dist/index.js

MCP Auth Behavior

Discovery methods (initialize, tools/list, resources/list, prompts/list, ping) can be public when PUBLIC_MCP_DISCOVERY=true.
tools/call requires valid upstream auth when MCP_API_KEY is set:
- Authorization: Bearer <MCP_API_KEY> or
- x-api-key: <MCP_API_KEY>

Xpay + Railway Configuration (Required)

Railway variables:

MCP_API_KEY=<your-strong-key>
PUBLIC_MCP_DISCOVERY=true
PUBLIC_BASE_URL=https://handoff-mcp-server-production.up.railway.app

Xpay MCP URL:

Use https://handoff-mcp-server-production.mcp.xpay.sh/mcp?key=xpay_sk_...
Without ?key=..., Xpay returns auth required and requests will not forward.

Client calls through Xpay:

Keep the Xpay key in URL.
Also send upstream auth header for tools/call (x-api-key or Bearer token matching MCP_API_KEY).

Publishing

MCP Registry

Server name: io.github.josephibra/handoff-mcp-server
Primary remote: Xpay URL (with key at client usage time, not committed)
Secondary remote: Railway URL

Smithery

Namespace: josephibrahim
Server ID: handoff-mcp-server
MCP Server URL: https://handoff-mcp-server-production.mcp.xpay.sh/mcp?key=xpay_sk_...

Agentverse

Create a new agent and attach MCP server:
- URL: https://handoff-mcp-server-production.mcp.xpay.sh/mcp?key=xpay_sk_...
- Headers: x-api-key: <MCP_API_KEY> for tool execution paths

Recommended Extra Discovery Listings

PulseMCP directory
mcp.so
OpenTools catalog
MCPmarket / mcpservers.org

Use the same canonical MCP URL and matching auth notes everywhere to avoid inconsistent behavior.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

FinAgent

Free

by mcp-marketplace · Finance

Free stock data and market news for any MCP-compatible AI assistant.

Handoff MCP Server

About

Security Report

Findings (1)

Permissions Required

How to Connect

Documentation

handoff-mcp-server

Endpoints

Environment Variables

Local Run

MCP Auth Behavior

Xpay + Railway Configuration (Required)

Publishing

MCP Registry

Smithery

Agentverse

Recommended Extra Discovery Listings

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Git

Toleno

mcp-creator-python

MarkItDown

FinAgent

Handoff MCP Server

About

Security Report

Findings (1)

Permissions Required

How to Connect

Documentation

handoff-mcp-server

Endpoints

Environment Variables

Local Run

MCP Auth Behavior

Xpay + Railway Configuration (Required)

Publishing

MCP Registry

Smithery

Agentverse

Recommended Extra Discovery Listings

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Git

Toleno

mcp-creator-python

MarkItDown

FinAgent