fastalert-mcp-server

FastAlert MCP Server

Official Model Context Protocol (MCP) server for FastAlert. This server allows AI agents (like Claude, ChatGPT, and Cursor) to list of your channels and send notifications directly through the FastAlert API.

Features

• Channel Discovery: List all of your channels with optional name filtering.
• Send Notifications: Send rich messages (title, content, actions, images) to one or multiple channels.

Quick Start

{
  "mcpServers": {
    "fastalert": {
      "command": "npx",
      "args": ["-y", "fastalert-mcp-server"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

You can find your API key by visiting FastAlert and navigating to Settings.

Available Tools

The following tools are available through this MCP server. Each tool can be called by an AI assistant to perform specific actions.

1. list_channels

Returns a list of available FastAlert channels.

Input Parameters:

• name (string, optional): A search term to filter channels by name.

Example Call:

{
  "name": "Service Alerts"
}

Structured JSON Output (Default):

{
  "status": true,
  "message": "You have fetch channels successfully",
  "data": {
    "channels": [
      {
        "uuid": "sdf12sdf-6541-5d56-s5sd-1fa513e88a81",
        "name": "Service Alerts",
        "subscriber": 1000
      }
    ]
  }
}

Human-Readable Text Output:

Here are your FastAlert channels:

Service Alerts
UUID: sdf12sdf-6541-5d56-s5sd-1fa513e88a81
Subscribers: 1000

2. send_message

Sends a notification message to one or more channels.

Input Parameters:

• channel-uuid (string, required): The unique identifier for the target channel.
• title (string, required): The title of the alert notification.
• content (string, required): The main body text of the notification.
• action (string, optional): Type of action ('call', 'email', 'website', 'image').
• action_value (string, optional): The value for the action (e.g., a URL or phone number).
• image (string, optional): URL or identifier for an image to include.

Example Call:

{
  "channel-uuid": "sdf12sdf-6541-5d56-s5sd-1fa513e88a81",
  "title": "System Update",
  "content": "A new version of the system is now live.",
  "action": "website",
  "action_value": "https://fastalert.now/updates"
}

Structured JSON Output (Default):

{
  "status": true,
  "message": "Message has been sent successfully"
}

Human-Readable Text Output:

Message Sent Successfully!

Your message "System Update" has been sent to Service Alerts.

Channel UUID: sdf12sdf-6541-5d56-s5sd-1fa513e88a81
Title: System Update
Content: A new version of the system is now live.

Integration with LLMs

Configuration in Cursor

• Go to Settings -> MCP.
• Click Add New MCP Server.
• Name: FastAlert
• Type: command
• Command: npx -y fastalert-mcp-server
• Env: Add API_KEY.

Configuration in ChatGPT

• Go to Settings -> Integrations.
• Click Add MCP Server.
• Use the hosted URL of your server (e.g., https://mcp.fastalert.now/mcp).
• Follow the OAuth prompts.

Configuration in Claude

• Open claude_desktop_config.json.
• Add the following entry:

{
  "mcpServers": {
    "fastalert": {
      "command": "npx",
      "args": ["-y", "fastalert-mcp-server"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Setup & Development

Requirements

• Node: Version 18 or higher is recommended.
• API_KEY: A valid FastAlert API Key is required for authentication.

Local Installation

• Clone the repository
• Copy the example environment file:

  cp .env.example .env
  

• Configure your environment variables in .env.
• Install dependencies:

  npm install
  

• Build the project:

  npm run build
  

• Run inspector tests:

  npm run inspector
  

• Run locally:

  npm start
  

Configuration (Environment Variables)

The following environment variables should be configured in your .env file:

Variable	Description	Example
API_URL	The FastAlert API endpoint	https://api.fastalert.now/api
FRONT_URL	Your frontend application URL	https://fastalert.now
BASE_URL	The public URL where this MCP server is hosted	http://localhost:3000
API_KEY	Your FastAlert API Key	your-api-key-here
PORT	(Optional) Port to run the server on	3000

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License.