# AgentSignal

> AgentSignal is a freemium MCP server for communication. Push notifications from scripts and AI agents to a person's phone, Mac or inbox. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $5 a month
- **Platforms:** iOS, macOS, API, CLI, Web
- **Repository:** https://github.com/data-group-ai/agentsignal
- **MCP Registry name:** net.agentsignal/mcp
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

The README says AgentSignal sends short, high-signal messages to a specific person's devices, whether the sender is a shell script, a cron job or an autonomous agent. Messages are written to a delivery record first and then pushed to Apple devices, with an SSE doorbell and polling as ways for agents to pick up messages.

Agents can reach people through a REST endpoint, a TypeScript SDK, a CLI, or this MCP server. The MCP server exposes notify and blocking ask tools, and which tools appear depends on whether an API key, a join token or neither is set. Sandbox keys create disposable projects whose deliveries count against the same monthly quota as live ones.

The project is aimed at developers and teams who want machine-sent alerts to reach people quickly, with per-channel branding, scheduling in plain language or cron, and idempotency keys so retries do not double-notify.

## Features

- **Idempotent message delivery:** Idempotency keys let a retrying agent avoid sending the same notification twice.
- **Multiple agent integration paths:** Agents can use REST, an MCP server, a TypeScript SDK or a CLI to send messages.
- **Scheduled sends:** One-off and recurring notifications can be set in plain language with a timezone, or as cron.
- **Per-channel branding:** Each channel can set its own name, icon, accent colour and notification sound.
- **Sandbox projects:** Throwaway sandbox projects are auto-purged so agents can be tested and removed without retention.
- **Apple device apps:** A SwiftUI client delivers notifications to iPhone, iPad and Mac, with Android and other platforms planned later.

## Good for

- Alerting a person when a deploy or cron job finishes
- Letting an autonomous agent ask a human a question and wait for the answer
- Sending urgent re-alerts until someone acknowledges a notification
- Pushing short status updates from scripts to a team's devices

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env AGENTSIGNAL_API_KEY='<AGENTSIGNAL_API_KEY>' --env AGENTSIGNAL_JOIN_TOKEN='<AGENTSIGNAL_JOIN_TOKEN>' -- npx -y @agentsignalnet/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agentsignalnet/mcp"
      ],
      "env": {
        "AGENTSIGNAL_API_KEY": "<AGENTSIGNAL_API_KEY>",
        "AGENTSIGNAL_JOIN_TOKEN": "<AGENTSIGNAL_JOIN_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agentsignalnet/mcp"
      ],
      "env": {
        "AGENTSIGNAL_API_KEY": "<AGENTSIGNAL_API_KEY>",
        "AGENTSIGNAL_JOIN_TOKEN": "<AGENTSIGNAL_JOIN_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agentsignalnet/mcp"
      ],
      "env": {
        "AGENTSIGNAL_API_KEY": "<AGENTSIGNAL_API_KEY>",
        "AGENTSIGNAL_JOIN_TOKEN": "<AGENTSIGNAL_JOIN_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agentsignalnet/mcp"
      ],
      "env": {
        "AGENTSIGNAL_API_KEY": "<AGENTSIGNAL_API_KEY>",
        "AGENTSIGNAL_JOIN_TOKEN": "<AGENTSIGNAL_JOIN_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agentsignalnet/mcp"
      ],
      "env": {
        "AGENTSIGNAL_API_KEY": "<AGENTSIGNAL_API_KEY>",
        "AGENTSIGNAL_JOIN_TOKEN": "<AGENTSIGNAL_JOIN_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Does the MCP server need an account?

The README says the server offers no-account x402 tools when no environment variables are set. An API key or join token adds further tools.

### How is usage priced?

The README lists Free at 1,000 deliveries per month, Starter at $5/mo, Growth at $10/mo, Max at $50/mo and pay-as-you-go per delivery in USDC on Base via x402. A delivery is one message reaching one device.

### Do sandbox keys cost less?

No. The README says sandbox deliveries count against the same monthly ceiling as live ones and overage never applies to them.

### Is AgentSignal free?

AgentSignal has a free plan, with paid plans for more usage or features. Paid plans start at $5 a month.

### How do I add AgentSignal to Claude Code?

Run this command in your terminal: claude mcp add mcp --env AGENTSIGNAL_API_KEY='<AGENTSIGNAL_API_KEY>' --env AGENTSIGNAL_JOIN_TOKEN='<AGENTSIGNAL_JOIN_TOKEN>' -- npx -y @agentsignalnet/mcp

### What are the best alternatives to AgentSignal?

The closest alternatives to AgentSignal are TrendRadar, Getmitra, Discord, Zoom and Email Spam Tester.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [TrendRadar](https://ai-powered.com/mcp/trendradar): TrendRadar is an open-source MCP server for communication.
- [Getmitra](https://ai-powered.com/mcp/getmitra): Getmitra is an MCP server for communication.
- [Discord](https://ai-powered.com/mcp/discord-2): Discord is a freemium MCP server for communication.
- [Zoom](https://ai-powered.com/mcp/zoom): Zoom is a freemium MCP server for communication.
- [Email Spam Tester](https://ai-powered.com/mcp/email-spam-tester): Email Spam Tester is a free MCP server for communication.
- [Slack_connect](https://ai-powered.com/mcp/slack-connect): Slack_connect is a freemium MCP server for communication.
- [Postmark](https://ai-powered.com/mcp/postmark): Postmark is a freemium MCP server for communication.
- [Gmail](https://ai-powered.com/mcp/gmail-5): Gmail is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/agentsignal
