MCP Notify

🚀 MCP Notify

Real-time monitoring and notifications for the MCP Registry ecosystem.

🚀 Quick Start

Using the Hosted Service

# Create a webhook subscription via API
curl -X POST https://watch.mcpregistry.dev/api/v1/subscriptions \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My DeFi Alerts",
    "filters": {
      "keywords": ["defi", "ethereum", "swap"],
      "namespaces": ["io.github.*"]
    },
    "channels": [{
      "type": "discord",
      "config": {
        "webhook_url": "https://discord.com/api/webhooks/..."
      }
    }]
  }'

Self-Hosted with Docker

# Clone the repository
git clone https://github.com/nirholas/mcp-notify.git
cd mcp-notify

# Configure environment
cp .env.example .env
# Edit .env with your settings

# Start services
docker compose up -d

# Access dashboard at http://localhost:8080

Using the CLI

# Install CLI
go install github.com/nirholas/mcp-notify/cmd/mcp-notify-cli@latest

# Check for recent changes
mcp-notify-cli changes --since 24h

# Watch with live output
mcp-notify-cli watch --filter "defi,blockchain" --output json

# Subscribe to notifications
mcp-notify-cli subscribe \
  --discord-webhook "https://discord.com/api/webhooks/..." \
  --filter "io.github.myorg/*"

✨ Features

Core Capabilities

• Real-time Monitoring: Poll the MCP Registry at configurable intervals
• Smart Diffing: Detect new servers, updates, version changes, and removals
• Flexible Filtering: Subscribe to specific namespaces, keywords, or server patterns
• Change History: Full audit trail of all detected changes with timestamps

Notification Channels

• Discord: Rich embeds with server details and direct links
• Slack: Interactive messages with action buttons
• Email: Digest emails (immediate, hourly, daily, weekly)
• Webhooks: Generic HTTP webhooks for custom integrations
• RSS/Atom: Subscribe via any feed reader
• Telegram: Bot notifications via Telegram Bot API
• Microsoft Teams: Adaptive Cards with full Teams integration

Deployment Options

• Hosted Service: Use our hosted instance at watch.mcpregistry.dev
• Self-Hosted: Deploy your own instance via Docker or Kubernetes
• CLI Tool: One-off checks and local monitoring

Developer Experience

• REST API: Full API for programmatic subscription management
• Web Dashboard: Visual configuration and monitoring interface
• Go SDK: Embed in your own applications
• OpenAPI Spec: Generate clients in any language

🏗️ Architecture

┌────────────────────────────────────────────────────────────────┐
│                        MCP Notify                              │
├────────────────────────────────────────────────────────────────┤
│                                                                │
│  ┌──────────┐    ┌──────────┐    ┌──────────────────────────┐  │
│  │  Poller  │───▶│  Differ  │───▶│  Notification Dispatcher │  │
│  └──────────┘    └──────────┘    └──────────────────────────┘  │
│       │               │                      │                 │
│       ▼               ▼                      ▼                 │
│  ┌──────────┐    ┌──────────┐    ┌──────────────────────────┐  │
│  │ Registry │    │ Snapshot │    │        Channels          │  │
│  │   API    │    │  Store   │    │  ┌───────┐ ┌───────────┐ │  │
│  └──────────┘    └──────────┘    │  │Discord│ │   Slack   │ │  │
│                       │          │  └───────┘ └───────────┘ │  │
│                       ▼          │  ┌───────┐ ┌───────────┐ │  │
│                  ┌──────────┐    │  │ Email │ │  Webhook  │ │  │
│                  │PostgreSQL│    │  └───────┘ └───────────┘ │  │
│                  └──────────┘    │  ┌───────┐               │  │
│                                  │  │  RSS  │               │  │
│                                  │  └───────┘               │  │
│                                  └──────────────────────────┘  │
│                                                                │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │                       REST API                           │  │
│  │  /subscriptions  /changes  /feeds  /health  /metrics     │  │
│  └──────────────────────────────────────────────────────────┘  │
│                                                                │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │                    Web Dashboard                         │  │
│  │  React + TypeScript + Tailwind + shadcn/ui               │  │
│  └──────────────────────────────────────────────────────────┘  │
│                                                                │
└────────────────────────────────────────────────────────────────┘

📦 Installation

Prerequisites

• Go 1.22+ (for building from source)
• PostgreSQL 15+ (for persistence)
• Redis 7+ (optional, for caching)
• Docker & Docker Compose (for containerized deployment)

From Source

git clone https://github.com/nirholas/mcp-notify.git
cd mcp-notify
make build
./bin/mcp-notify --config config.yaml

Docker

docker pull ghcr.io/nirholas/mcp-notify:latest
docker run -p 8080:8080 -v $(pwd)/config.yaml:/app/config.yaml \
  ghcr.io/nirholas/mcp-notify:latest

Kubernetes

helm repo add mcp-notify https://YOUR_USERNAME.github.io/mcp-notify
helm install mcp-notify mcp-notify/mcp-notify \
  --set config.registryUrl=https://registry.modelcontextprotocol.io \
  --set notifications.discord.enabled=true

🔧 Configuration

Environment Variables

Configuration File

# config.yaml
server:
  port: 8080
  host: "0.0.0.0"
  cors:
    origins: ["*"]

registry:
  url: "https://registry.modelcontextprotocol.io"
  poll_interval: 5m
  timeout: 30s
  retry_attempts: 3

database:
  url: "postgres://user:pass@localhost:5432/mcp_watch?sslmode=disable"
  max_connections: 25
  
redis:
  url: "redis://localhost:6379/0"
  
notifications:
  discord:
    enabled: true
    rate_limit: 30/min
  slack:
    enabled: true
    rate_limit: 30/min
  email:
    enabled: true
    smtp:
      host: "smtp.example.com"
      port: 587
      username: ""
      password: ""
      from: "mcp-notify@example.com"
  webhook:
    enabled: true
    timeout: 10s
    retry_attempts: 3
  rss:
    enabled: true
    items_per_feed: 100
    
telemetry:
  metrics:
    enabled: true
    port: 9090
  tracing:
    enabled: false
    endpoint: ""

📡 API Reference

Subscriptions

# Create subscription
POST /api/v1/subscriptions

# List subscriptions
GET /api/v1/subscriptions

# Get subscription
GET /api/v1/subscriptions/{id}

# Update subscription
PUT /api/v1/subscriptions/{id}

# Delete subscription
DELETE /api/v1/subscriptions/{id}

# Pause/resume subscription
POST /api/v1/subscriptions/{id}/pause
POST /api/v1/subscriptions/{id}/resume

Changes

# Get recent changes
GET /api/v1/changes?since=2025-01-01T00:00:00Z&limit=100

# Get change details
GET /api/v1/changes/{id}

# Get changes for specific server
GET /api/v1/changes?server=io.github.example/my-server

Feeds

# RSS feed (all changes)
GET /api/v1/feeds/rss

# Atom feed (all changes)
GET /api/v1/feeds/atom

# Filtered feed
GET /api/v1/feeds/rss?namespace=io.github.*&keywords=defi

Health & Metrics

# Health check
GET /health

# Readiness check
GET /ready

# Prometheus metrics
GET /metrics

Full API documentation available at /api/docs when running the server, or see docs/api/openapi.yaml.

🔔 Notification Formats

Discord

Rich embeds include:

• Server name and description
• Change type (new, updated, removed)
• Version information
• Direct link to registry
• Package registry links (npm, PyPI, etc.)

Slack

Interactive messages with:

• Expandable server details
• Quick action buttons
• Thread support for related changes

Email Digest

Configurable digest emails:

• Immediate (per-change)
• Hourly summary
• Daily digest
• Weekly roundup

Webhook Payload

{
  "event_type": "server.updated",
  "timestamp": "2025-01-04T12:00:00Z",
  "server": {
    "name": "io.github.example/my-server",
    "description": "An example MCP server",
    "version": "2.0.0",
    "previous_version": "1.5.0",
    "packages": [...],
    "remotes": [...]
  },
  "changes": [
    {
      "field": "version",
      "old_value": "1.5.0",
      "new_value": "2.0.0"
    },
    {
      "field": "description",
      "old_value": "...",
      "new_value": "..."
    }
  ],
  "registry_url": "https://registry.modelcontextprotocol.io/v0/servers/io.github.example%2Fmy-server"
}

📸 Screenshots

📖 Documentation

🧪 Testing

# Run unit tests
make test

# Run integration tests (requires Docker)
make test-integration

# Run e2e tests
make test-e2e

# Run all tests with coverage
make test-coverage

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Setup

# Clone repo
git clone https://github.com/nirholas/mcp-notify.git
cd mcp-notify

# Install dependencies
make deps

# Start development services
make dev-services

# Run in development mode with hot reload
make dev

# Run linters
make lint

# Generate code (API clients, mocks, etc.)
make generate

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Model Context Protocol team for the protocol and registry
• MCP Registry maintainers
• All contributors to this project

📞 Support

• Documentation: docs/
• Issues: GitHub Issues
• Discussions: GitHub Discussions
• X (Twitter): @nichxbt

🌐 Live HTTP Deployment

MCP Notify is deployed and accessible over HTTP via MCP Streamable HTTP transport — no local installation required.

Endpoint:

https://modelcontextprotocol.name/mcp/mcp-notify

Connect from any MCP Client

Add to your MCP client configuration (Claude Desktop, Cursor, SperaxOS, etc.):

{
  "mcpServers": {
    "mcp-notify": {
      "type": "http",
      "url": "https://modelcontextprotocol.name/mcp/mcp-notify"
    }
  }
}

Available Tools (2)

Example Requests

List popular MCP servers:

curl -X POST https://modelcontextprotocol.name/mcp/mcp-notify \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_mcp_servers","arguments":{}}}'

Search MCP servers:

curl -X POST https://modelcontextprotocol.name/mcp/mcp-notify \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_mcp_servers","arguments":{"query":"crypto"}}}'

List All Tools

curl -X POST https://modelcontextprotocol.name/mcp/mcp-notify \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Also Available On

• SperaxOS — Browse and install from the MCP marketplace
• All 27 MCP servers — See the full catalog at modelcontextprotocol.name

Powered by modelcontextprotocol.name — the open MCP HTTP gateway