Server data from the Official MCP Registry
Let AI agents notify you on Slack, Telegram, email, SMS, or push via an Alphorn webhook.
About
Let AI agents notify you on Slack, Telegram, email, SMS, or push via an Alphorn webhook.
Security Report
Valid MCP server (4 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
6 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: ALPHORN_WEBHOOK_URL
Environment variable: ALPHORN_API_KEY
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-alphorn-dev-mcp": {
"env": {
"ALPHORN_API_KEY": "your-alphorn-api-key-here",
"ALPHORN_WEBHOOK_URL": "your-alphorn-webhook-url-here"
},
"args": [
"-y",
"@alphorn/mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
Alphorn MCP Server
MCP server for Alphorn, the open-source notification router. It gives AI agents (Claude Code, Claude Desktop, Cursor, Codex, and any other MCP client) a send_notification tool, so an agent can tell you when a task finishes, fails, or needs your decision, on whatever channel you configured in Alphorn: Slack, Telegram, Discord, email, SMS, push, and more.
Works with the hosted service at app.alphorn.dev and with self-hosted Alphorn.
Setup
- Create a webhook in Alphorn and copy its Endpoint URL, plus its API key if you switched on Require API key (docs).
- Add the server to your MCP client with two environment variables:
| Variable | Value |
|---|---|
ALPHORN_WEBHOOK_URL | Endpoint URL, e.g. https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT |
ALPHORN_API_KEY | Webhook API key (alp_...). Leave unset if the webhook does not require one. |
Claude Code
claude mcp add alphorn -s user \
-e ALPHORN_WEBHOOK_URL=https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT \
-e ALPHORN_API_KEY=alp_... \
-- npx -y @alphorn/mcp
Claude Desktop (one-click bundle)
Download alphorn.mcpb from the latest release and open it. Claude Desktop asks for the Endpoint URL and API key.
Claude Desktop, Cursor, and other JSON-configured clients
Add to claude_desktop_config.json, ~/.cursor/mcp.json, or your client's MCP config:
{
"mcpServers": {
"alphorn": {
"command": "npx",
"args": ["-y", "@alphorn/mcp"],
"env": {
"ALPHORN_WEBHOOK_URL": "https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT",
"ALPHORN_API_KEY": "alp_..."
}
}
}
}
OpenAI Codex CLI
# ~/.codex/config.toml
[mcp_servers.alphorn]
command = "npx"
args = ["-y", "@alphorn/mcp"]
env = { ALPHORN_WEBHOOK_URL = "https://app.alphorn.dev/n/V1StGXR8_Z5jdHi6B-myT", ALPHORN_API_KEY = "alp_..." }
Tool
send_notification
| Argument | Type | Required | Description |
|---|---|---|---|
message | string | yes | What happened and what the agent needs from you (max 4,000 characters) |
title | string | no | Short title, e.g. my-app - tests passing (max 200 characters) |
priority | integer 1-5 | no | 2 = finished, 3 = needs input, 4 = blocked or failed, 5 = urgent |
tags | string[] | no | Tags to filter and route on in Alphorn, e.g. ["ai-agent", "completed"] |
The tool wraps Alphorn's send endpoint. For direct HTTP use, see the API reference and the OpenAPI 3.1 specification.
Use Alphorn's filters to decide where each notification goes, for example SMS only for priority 4 and above.
Development
pnpm install
pnpm test # builds, then runs the tests against a local fake endpoint
Releasing
- Bump
versioninpackage.json,server.json(both fields),manifest.json, andVERSIONinsrc/server.ts. npm publish --access public- Push a
v<version>tag (or run the Publish to MCP Registry workflow): it publishesserver.jsonto the MCP Registry via GitHub OIDC pnpm bundle, then attachalphorn.mcpbto a GitHub release
License
AGPL-3.0-or-later
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Worldmonitor
Freeby Koala73 · Developer Tools
Live markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.