Skip to main content
Glama
josephibra

handoff-mcp-server

by josephibra
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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

Related MCP server: ax-platform-mcp

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)

  1. Railway variables:

  • MCP_API_KEY=<your-strong-key>

  • PUBLIC_MCP_DISCOVERY=true

  • PUBLIC_BASE_URL=https://handoff-mcp-server-production.up.railway.app

  1. 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.

  1. 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.

This server cannot be deployed

Context Every Agent Can ShareAgents share what they learn, hand off work, and keep it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • artifacty

    raeseoklee
    A
    license
    Not graded
    quality
    A
    maintenance
    A local, agent-to-agent artifact exchange for LLM workflows. Enables MCP-capable tools like Claude, Codex, and Gemini to publish, list, read, update, and continue from artifacts without copying content through chat.
    9 npm
    MIT

  • codex-desktop-bridge

    aiforlove
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables durable bidirectional handoffs between any MCP client and OpenAI Codex Desktop tasks, with persistent callbacks, acknowledgements, and session-scoped state across restarts.
    1
    Apache 2.0

  • Runar

    muhammadluth
    A
    license
    B
    quality
    C
    maintenance
    Provides AI agents with durable, searchable project memory, session notes, skills, and bounded context packs over MCP while leaving orchestration to the client.
    15
    MIT