{
  "markdown": "# FastAlert MCP Server\n\nOfficial Model Context Protocol (MCP) server for [FastAlert](https://fastalert.now). This server allows AI agents (like Claude, ChatGPT, and Cursor) to list of your channels and send notifications directly through the FastAlert API.\n\n## Features\n\n- **Channel Discovery**: List all of your channels with optional name filtering.\n- **Send Notifications**: Send rich messages (title, content, actions, images) to one or multiple channels.\n\n## Quick Start\n\n```json\n{\n  \"mcpServers\": {\n    \"fastalert\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"fastalert-mcp-server\"],\n      \"env\": {\n        \"API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\nYou can find your API key by visiting [FastAlert](https://fastalert.now) and navigating to [Settings](https://fastalert.now/settings).\n\n## Available Tools\n\nThe following tools are available through this MCP server. Each tool can be called by an AI assistant to perform specific actions.\n\n### 1. `list_channels`\n\nReturns a list of available FastAlert channels.\n\n**Input Parameters:**\n\n- `name` (string, optional): A search term to filter channels by name.\n\n**Example Call:**\n\n```json\n{\n  \"name\": \"Service Alerts\"\n}\n```\n\n**Structured JSON Output (Default):**\n\n```json\n{\n  \"status\": true,\n  \"message\": \"You have fetch channels successfully\",\n  \"data\": {\n    \"channels\": [\n      {\n        \"uuid\": \"sdf12sdf-6541-5d56-s5sd-1fa513e88a81\",\n        \"name\": \"Service Alerts\",\n        \"subscriber\": 1000\n      }\n    ]\n  }\n}\n```\n\n**Human-Readable Text Output:**\n\n```text\nHere are your FastAlert channels:\n\nService Alerts\nUUID: sdf12sdf-6541-5d56-s5sd-1fa513e88a81\nSubscribers: 1000\n```\n\n### 2. `send_message`\n\nSends a notification message to one or more channels.\n\n**Input Parameters:**\n\n- `channel-uuid` (string, required): The unique identifier for the target channel.\n- `title` (string, required): The title of the alert notification.\n- `content` (string, required): The main body text of the notification.\n- `action` (string, optional): Type of action ('call', 'email', 'website', 'image').\n- `action_value` (string, optional): The value for the action (e.g., a URL or phone number).\n- `image` (string, optional): URL or identifier for an image to include.\n\n**Example Call:**\n\n```json\n{\n  \"channel-uuid\": \"sdf12sdf-6541-5d56-s5sd-1fa513e88a81\",\n  \"title\": \"System Update\",\n  \"content\": \"A new version of the system is now live.\",\n  \"action\": \"website\",\n  \"action_value\": \"https://fastalert.now/updates\"\n}\n```\n\n**Structured JSON Output (Default):**\n\n```json\n{\n  \"status\": true,\n  \"message\": \"Message has been sent successfully\"\n}\n```\n\n**Human-Readable Text Output:**\n\n```text\nMessage Sent Successfully!\n\nYour message \"System Update\" has been sent to Service Alerts.\n\nChannel UUID: sdf12sdf-6541-5d56-s5sd-1fa513e88a81\nTitle: System Update\nContent: A new version of the system is now live.\n```\n\n## Integration with LLMs\n\n### Configuration in Cursor\n\n1. Go to **Settings** -> **MCP**.\n2. Click **Add New MCP Server**.\n3. Name: `FastAlert`\n4. Type: `command`\n5. Command: `npx -y fastalert-mcp-server`\n6. Env: Add `API_KEY`.\n\n### Configuration in ChatGPT\n\n1. Go to **Settings** -> **Integrations**.\n2. Click **Add MCP Server**.\n3. Use the hosted URL of your server (e.g., `https://mcp.fastalert.now/mcp`).\n4. Follow the OAuth prompts.\n\n### Configuration in Claude\n\n1. Open `claude_desktop_config.json`.\n2. Add the following entry:\n\n```json\n{\n  \"mcpServers\": {\n    \"fastalert\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"fastalert-mcp-server\"],\n      \"env\": {\n        \"API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n## Setup & Development\n\n### Requirements\n\n- **Node**: Version 18 or higher is recommended.\n- **API_KEY**: A valid FastAlert API Key is required for authentication.\n\n### Local Installation\n\n1. Clone the repository\n2. Copy the example environment file:\n   ```bash\n   cp .env.example .env\n   ```\n3. Configure your environment variables in `.env`.\n4. Install dependencies:\n   ```bash\n   npm install\n   ```\n5. Build the project:\n   ```bash\n   npm run build\n   ```\n6. Run inspector tests:\n   ```bash\n   npm run inspector\n   ```\n7. Run locally:\n   ```bash\n   npm start\n   ```\n\n### Configuration (Environment Variables)\n\nThe following environment variables should be configured in your `.env` file:\n\n| Variable    | Description                                    | Example                         |\n| ----------- | ---------------------------------------------- | ------------------------------- |\n| `API_URL`   | The FastAlert API endpoint                     | `https://api.fastalert.now/api` |\n| `FRONT_URL` | Your frontend application URL                  | `https://fastalert.now`         |\n| `BASE_URL`  | The public URL where this MCP server is hosted | `http://localhost:3000`         |\n| `API_KEY`   | Your FastAlert API Key                         | `your-api-key-here`             |\n| `PORT`      | (Optional) Port to run the server on           | `3000`                          |\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License.\n\n---",
  "bytes": 5127,
  "sha": "041d41b5ebdb0ac84dd4daf7b99476b2e8d45c5f431eb2639ae206b0547c88f3",
  "repo_slug": "fastalertnow/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_fastalertnow_mcp_server_13d5c26b/readme"
}