Ntfy Push Notification

Instructions

Implementation Reference

• mcp_notify/other.py:147-184 (handler)

  Handler function that sends a push notification via Ntfy. Builds a JSON payload with topic, title, message, click URL, icon, markdown flag, priority, delay, optional attachment, and actions, then POSTs it to the configured Ntfy base URL.

  def ntfy_send_notify(
      message: str = Field(description="Notification message body; set to `triggered` if empty or not passed"),
      title: str = Field("", description="Notification title"),
      topic: str = Field("", description="Target topic name or URL"),
      click: str = Field("", description="URL opened when notification is clicked"),
      attach: str = Field("", description="URL of an attachment"),
      icon: str = Field("", description="URL of notification icon"),
      markdown: bool = Field(False, description="Set to `true` if the message is Markdown-formatted"),
      filename: str = Field("", description="File name of the attachment"),
      priority: int = Field(3, description="Message priority with 1=min, 3=default and 5=max"),
      delay: str = Field("", description="Timestamp or duration for delayed delivery. Example: 30min, 9am"),
      actions: list | None = Field(None, description=f"List of action buttons.{NTFY_ACTIONS_RULE}"),
  ):
      """
      https://docs.ntfy.sh/publish/#publish-as-json
      """
      base = os.getenv("NTFY_BASE_URL") or "https://ntfy.sh"
      if topic and topic.startswith("http"):
          base, topic = topic.rsplit("/", 1)
      if not topic:
          topic = os.getenv("NTFY_DEFAULT_TOPIC", "")
      data = {
          "topic": topic,
          "title": title,
          "message": message,
          "click": click,
          "icon": icon,
          "markdown": markdown or False,
          "priority": priority,
          "delay": delay,
      }
      if attach:
          data["attach"] = attach
          data["filename"] = filename
      if actions:
          data["actions"] = actions
      res = requests.post(f"{base}", json=data)
      return res.json()

• mcp_notify/other.py:148-158 (schema)

  Input schema for ntfy_send_notify using Pydantic Field definitions. Supports message, title, topic, click, attach, icon, markdown, filename, priority, delay, and actions parameters.

  message: str = Field(description="Notification message body; set to `triggered` if empty or not passed"),
  title: str = Field("", description="Notification title"),
  topic: str = Field("", description="Target topic name or URL"),
  click: str = Field("", description="URL opened when notification is clicked"),
  attach: str = Field("", description="URL of an attachment"),
  icon: str = Field("", description="URL of notification icon"),
  markdown: bool = Field(False, description="Set to `true` if the message is Markdown-formatted"),
  filename: str = Field("", description="File name of the attachment"),
  priority: int = Field(3, description="Message priority with 1=min, 3=default and 5=max"),
  delay: str = Field("", description="Timestamp or duration for delayed delivery. Example: 30min, 9am"),
  actions: list | None = Field(None, description=f"List of action buttons.{NTFY_ACTIONS_RULE}"),

• mcp_notify/other.py:143-146 (registration)

  Registration of the 'ntfy_send_notify' function as an MCP tool via the @mcp.tool() decorator with title 'Ntfy Push Notification' and description 'Push a notification via Ntfy'.

  @mcp.tool(
      title="Ntfy Push Notification",
      description="Push a notification via Ntfy",
  )

• mcp_notify/__init__.py:18-23 (registration)

  Module-level registration: 'other.add_tools(mcp)' is called, which is the function that contains the @mcp.tool decorator for ntfy_send_notify.

  mcp = FastMCP(name="mcp-notify", version="0.1.11")
  wework.add_tools(mcp)
  tgbot.add_tools(mcp)
  other.add_tools(mcp)
  hass.add_tools(mcp)
  util.add_tools(mcp)

• mcp_notify/other.py:6-35 (helper)

  Helper constant NTFY_ACTIONS_RULE providing documentation for the 'actions' parameter, describing view, broadcast, and http action types with JSON examples.

  NTFY_ACTIONS_RULE = """
  The following actions are supported:
  - view: Opens a website or app when the action button is tapped
  - broadcast: Sends an Android broadcast intent when the action button is tapped (only supported on Android)
  - http: Sends HTTP POST/GET/PUT request when the action button is tapped
  ```json
  [
    {
      "action": "view",
      "label": "Open portal",
      "url": "https://home.nest.com/",
      "clear": true
    },
    {
      "action": "http",
      "label": "Turn down",
      "url": "https://api.nest.com/",
      "body": "{\"temperature\": 65}"
    },
    {
      "action": "broadcast",
      "label": "Take picture",
      "extras": {
          "cmd": "pic",
          "camera": "front"
      }
    }
  ]
  ```
  """