Skip to content

CLI Reference

The mcp-notify-cli command-line tool for interacting with MCP Notify.

Installation

Bash
go install github.com/nirholas/mcp-notify/cmd/mcp-notify-cli@latest

Global Flags

Flag Description Default
--api-url API endpoint URL http://localhost:8080
--api-key API key for authentication -
--output Output format: table, json, yaml table
--config Config file path ~/.mcp-notify/config.yaml
--verbose Enable verbose output false

Commands

Quick Examples

Bash
# View recent changes
mcp-notify-cli changes --since 24h

# Watch in real-time
mcp-notify-cli watch --interval 1m

# Create a Discord subscription
mcp-notify-cli subscribe discord \
  --webhook-url "https://discord.com/api/webhooks/..." \
  --name "My Alerts"

# List your subscriptions
mcp-notify-cli subscriptions list

# Search for servers
mcp-notify-cli servers search "database"

# Output as JSON
mcp-notify-cli changes --output json

Configuration File

Create ~/.mcp-notify/config.yaml:

YAML
api_url: "http://localhost:8080"
api_key: "mcp_xxxxxxxxxxxx"
output: table

watch:
  interval: 5m
  sound: true

changes:
  limit: 50
  since: 24h

Shell Completion

Generate shell completion scripts:

Bash
mcp-notify-cli completion bash > /etc/bash_completion.d/mcp-notify-cli
Bash
mcp-notify-cli completion zsh > "${fpath[1]}/_mcp-notify-cli"
Bash
mcp-notify-cli completion fish > ~/.config/fish/completions/mcp-notify-cli.fish
PowerShell
mcp-notify-cli completion powershell > mcp-notify-cli.ps1