Pushover Alert Dispatcher MCP

An implementation of the Model Context Protocol engineered for relaying communications via the Pushover.net infrastructure.

Synopsis

This MCP allows synthetic intelligences (AI agents) to broadcast messages using Pushover.net. It strictly adheres to the MCP specification, ensuring smooth interoperability with compatible AI orchestration platforms.

Initialization Requirements

To activate this capability, you must possess: 1. An application authentication token obtained from Pushover.net. 2. Your designated recipient user key, also sourced from Pushover.net.

Retrieve these credentials from your Pushover.net credentials portal.

Protocol Interface Definition

The MCP exposes a singular callable primitive:

send_notification

Triggers the transmission of a message through the Pushover channel.

{
  message_body: string;     // Mandatory: The payload content of the alert
  alert_label?: string;     // Optional: A summary header for the notification
  urgency_level?: number;   // Optional: Severity range from -2 (minimal) to 2 (critical/fail-safe)
  audio_cue?: string;       // Optional: Specification for the alert sound to play
  associated_link?: string; // Optional: A Uniform Resource Locator (URL) to embed
  link_descriptor?: string; // Optional: Label text displayed for the embedded URL
  target_endpoint_id?: string; // Optional: Identifier for a specific receiving device
}

Illustrative MCP Invocation

{
  "name": "send_notification",
  "params": {
    "message_body": "System health check complete.",
    "alert_label": "Automated Status Report",
    "urgency_level": 0
  }
}

Deployment Instructions

Integration within Cursor IDE

Strategy A: System-Wide Initialization

Execute the MCP server daemon using npx:

npx -y pushover-mcp@latest start --token YOUR_TOKEN --user YOUR_USER

Within the Cursor Integrated Development Environment:

1. Navigate to Cursor Settings followed by the MCP section.
2. Select the option to + Add New MCP Server.
3. Populate the configuration fields:
4. Alias: Pushover Alert Service (or an alternative identifier)
5. Type: command
6. Command String: npx -y pushover-mcp@latest start --token YOUR_TOKEN --user YOUR_USER

Strategy B: Project-Scoped Configuration

Establish an override file named .cursor/mcp.json within the project root:

{
  "mcpServers": {
    "pushover_relay": {
      "command": "npx",
      "args": [
        "-y",
        "pushover-mcp@latest",
        "start",
        "--token",
        "YOUR_TOKEN",
        "--user", 
        "YOUR_USER"
      ]
    }
  }
}

Utilizing the Tool

Once registered, the Pushover dispatch primitive becomes immediately accessible to the Cursor AI Agent subsystem. Actions include:

1. Verification: The tool will appear in the list under MCP settings.
2. Automatic Invocation: The Agent will engage the tool when contextually appropriate.
3. Explicit Command: Users can direct the Agent to send alerts.

By default, the Agent requires explicit user confirmation prior to dispatch. To permit autonomous transmission, activate the "Yolo mode" setting.

Integration within Roo Code Environment

Access the configuration interface via the “Edit MCP Settings” menu item in Roo Code settings, or invoke the “Roo Code: Open MCP Config” command via the VS Code command palette.

{
  "mcpServers": {
    "pushover_connector": {
      "command": "npx",
      "args": [
        "-y",
        "pushover-mcp@latest",
        "start",
        "--token",
        "YOUR_TOKEN",
        "--user", 
        "YOUR_USER"
      ]
    }
  }
}

1. The Pushover communication mechanism will be provisioned for Roo Code's analytical agents.

Caveat: Ensure substitution of YOUR_TOKEN and YOUR_USER placeholders with valid Pushover credentials.

Installation via Smithery

For automated deployment of the Pushover Notification Agent to Claude Desktop environments using Smithery:

npx -y @smithery/cli install @AshikNesin/pushover-mcp --client claude

Development Lifecycle

# Dependency acquisition
pnpm install

# Artifact generation
pnpm build

# Validation procedures
pnpm test

Intellectual Property

Licensed under the MIT Framework.