Zona MCP

An MCP server that sends alerts to the Zona inbox from an AI CLI. The source token is read locally and never printed.

Tools

Related MCP server: ntfy-mcp

Requirements

• Node.js 20+ (fetch, FormData, and crypto.randomUUID).

Install

cd mcp
npm ci

Configuration

Grok

[mcp_servers.zona]
command = "node"
args = ["/absolute/path/to/mcp/server.mjs"]
enabled = true

On Windows, set MSYS = "noglob" in [mcp_servers.zona.env] if you use MSYS.

Claude / Cursor / other stdio hosts

{
  "mcpServers": {
    "zona": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/server.mjs"]
    }
  }
}

Restart the CLI after changing MCP config.

Token

In the Zona app, open Sources, create a source (or a new key), copy the zona_live_... token once, and save it as a single line in:

~/.zona/token

On Windows that is %USERPROFILE%\.zona\token. Treat it like a password. You can also set ZONA_SOURCE_TOKEN.

HTTP (no MCP)

POST https://gerncrjtrdjtjvybvseb.supabase.co/functions/v1/notify
Authorization: Bearer zona_live_YOUR_SOURCE_TOKEN
Idempotency-Key: unique-event-id
Content-Type: application/json

{
  "title": "Build complete",
  "body": "The release finished.",
  "category": "build",
  "severity": "medium"
}

Pictures use multipart/form-data and repeat the attachment part once per file (max five). Full sender guide: Send alerts to Zona.

Agent skill

SKILL.md in this folder is the prompt for AI CLIs (/zona). Copy it into the host's skills directory.

License

MIT