Blue Matador Server

npm version

Connect your Bluematador monitoring to Claude Desktop and Claude Code securely with your credentials stored locally.

---

🚀 Quick Start

Requirements

• Node.js: 16.x or higher

Installation

Install the Bluematador MCP server as an npm package:

npm install -g blue-matador-mcp-server

📦 View on npm

Configuration

1. Get your API Key and Account ID from Bluematador Settings → API Keys

2. Open Claude Desktop → Settings → Developer → Edit Config

3. Add the Bluematador MCP server to your configuration:

{
  "mcpServers": {
    "bluematador": {
      "command": "bluematador-mcp-server",
      "env": {
        "BLUEMATADOR_API_KEY": "your-api-key-here",
        "BLUEMATADOR_ACCOUNT_ID": "your-account-id-here"
      }
    }
  }
}

4. Save the file and restart Claude Desktop

---

🖥️ Compatibility

✅ Works With

• Claude Desktop (macOS, Windows, Linux)
• Claude Code (CLI tool)
• Claude Dev (VS Code extension)

❌ Does Not Work With

• Claude Web (claude.ai)
• ChatGPT or other AI platforms

---

✨ What You Can Do

Ask Claude to help with your Bluematador monitoring using natural language:

🔗 Cloud Integration Management

• Set up and manage AWS/Azure monitoring
• Enable, disable, or update integrations
• View integration status and troubleshoot issues

📊 Monitoring & Alerts

• Check active alerts and events in real-time
• Query historical monitoring data
• Get infrastructure health summaries
• View metrics and performance data

🔕 Alert Management

• Create mute rules for specific alerts or resources
• Mute monitors by service type (SQS, RDS, EC2, etc.)
• Use wildcard patterns for bulk operations
• Control alert visibility and notifications

🔔 Notification Setup

• Configure Email, PagerDuty, OpsGenie
• Set up AWS SNS, VictorOps, SquadCast
• Manage ServiceNow integrations
• Control alert severity levels

👥 Team & Project Management

• Invite team members
• Manage user permissions
• Organize monitoring by projects

---

📚 Documentation

• API Reference - Complete tool reference

---

🔒 Security & Privacy

• Per-user credentials - Each user provides their own API keys in their local configuration
• Direct API calls - All requests go directly to Bluematador's API
• HTTPS only - All connections are encrypted
• Audit trail - All actions logged in your Bluematador account

---

💡 Example Usage

Once connected, use natural language with Claude:

You: "Show me active Bluematador alerts"
You: "Create a mute rule for all SQS monitors in us-east-1"
You: "List my AWS integrations"
You: "Invite [email protected] as an admin"
You: "What EC2 instances have high CPU?"

---

🛠️ For Developers

If you want to contribute or run the server locally for development, see DEV-README.md

---

📄 License

MIT License - see LICENSE for details

---

🆘 Support

• Issues: GitHub Issues
• Documentation: Bluematador Docs
• MCP Protocol: Model Context Protocol

---

Made with ❤️ by Bluematador

Website • Documentation • GitHub