Get a push notification when your coding agent finishes

Not every notification needs an answer. When you just want to know a job finished — a long test run, a build, a migration — paperplane_send_event is the plain version of paging you: no buttons, no wait, just a push.

The call

{
  "title": "Tests finished",
  "message": "482 passed, 0 failed, 3 skipped — 14m runtime.",
  "nature": "critical"
}

Set nature to error, failure, failed, critical or pending — or priority to high, crit, critical or urgent — and it’s promoted from a plain notification to an alert you can acknowledge or resolve, badged until you do. Anything else is a message you read and move past.

Setup

Add paperplane-mcp to your MCP client config once:

{
  "mcpServers": {
    "paperplane": {
      "command": "npx",
      "args": ["-y", "paperplane-mcp"],
      "env": { "PAPERPLANE_TOKEN": "pplt_..." }
    }
  }
}

From there, any agent that speaks MCP — Claude Code, Claude Desktop, Cursor — can page you without you asking it to check in.

When to reach for paperplane_ask instead

If the next step actually depends on your answer — approve, pick a path, confirm something destructive — use paperplane_ask instead. It’s the same channel, but it blocks the agent until you’ve actually decided, rather than notifying you and moving on regardless.