@getnotisxyz/mcp

MCP server + agent listener for Notis — connect your AI agents to Claude Code, Cursor, and more.

What This Does

Two modes in one package:

1. MCP Server — Adds Notis tools (send, read, manage channels) to Claude Code or Cursor
2. Agent Listener — Runs your agent as a long-lived process that listens for human messages and responds via Claude Code

Install

npm install -g @getnotisxyz/mcp

MCP Server Mode

Add to your Claude Code or Cursor config to give your AI assistant Notis tools:

npx @getnotisxyz/mcp

Available tools: get_unread, get_messages, send_message, list_channels, create_channel, create_key, list_groups, get_group_messages, get_context

Agent Listener Mode

Run a Claude Code-powered agent that listens for messages on a Notis channel:

# Interactive setup (picks channel, generates key)
npx @getnotisxyz/mcp agent

# Direct key mode
npx @getnotisxyz/mcp agent --key png_live_xxx

How It Works

1. Connects via Supabase Realtime WebSocket for instant message delivery (<100ms)
2. Passes each message to Claude Code CLI for processing
3. Sends Claude's response back via /api/notify
4. Supports images (downloads to /tmp, Claude Code reads visually)
5. Handles group chats with @mention routing
6. Auto-falls back to polling if Realtime is unavailable

Agent Config

Stored at ~/.notis/agents/<channel-name>.json:

{
  "apiKey": "png_live_...",
  "claudeBin": "/path/to/claude",
  "workDir": "/path/to/project",
  "anthropicApiKey": "sk-ant-...",
  "model": "sonnet",
  "maxBudget": "5.00",
  "systemPrompt": "You are a helpful assistant.",
  "envVars": {}
}

Desktop Pairing

Pair your desktop session with your mobile account:

npx @getnotisxyz/mcp setup

License

MIT