Ray notifications MCP Server

by gege-mnio.github.gege-mn/ray-mcpv0.1.0

Local stdio MCP server for Ray, the notification delivery API (email, push, Slack, Discord, Telegram, webhooks). Bridges to Ray's hosted MCP endpoint.

0Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active20d ago

Install Ray notifications MCP server

claude mcp add ray -e RAY_API_KEY='<ray-api-key>' -- npx -y @gege-mn/ray-mcp

{
  "mcpServers": {
    "ray": {
      "command": "npx",
      "args": [
        "-y",
        "@gege-mn/ray-mcp"
      ],
      "env": {
        "RAY_API_KEY": "<ray-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "ray": {
      "command": "npx",
      "args": [
        "-y",
        "@gege-mn/ray-mcp"
      ],
      "env": {
        "RAY_API_KEY": "<ray-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "ray": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@gege-mn/ray-mcp"
      ],
      "env": {
        "RAY_API_KEY": "<ray-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "ray": {
      "command": "npx",
      "args": [
        "-y",
        "@gege-mn/ray-mcp"
      ],
      "env": {
        "RAY_API_KEY": "<ray-api-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
RAY_API_KEY	yes	yes	Ray API key (ck_live_...). Create one at https://ray.gege.mn under API keys; use the write scope to send and edit.
RAY_MCP_URL	—	—	Hosted Ray MCP endpoint to bridge to. Only change this for self-hosted or staging deployments.

Remote endpoints

streamable-httphttps://ray-api.gege.mn/mcp

Freshness

Active — last maintenance signal 20d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-19 · 20d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-14 · 25d ago · official registry · v0.1.0

FAQ

›How do I install the Ray notifications MCP server in Claude Code?

Run: claude mcp add ray -e RAY_API_KEY='<ray-api-key>' -- npx -y @gege-mn/ray-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Ray notifications require an API key?

Yes. It expects RAY_API_KEY, of which 1 is a secret.

›Can I use Ray notifications as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Ray notifications in the official MCP registry?

Yes, as io.github.gege-mn/ray-mcp.