firewalla-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FIREWALLA_BOX_ID | Yes | Your Firewalla Box GID (Group ID) found in device settings | |
| FIREWALLA_MSP_ID | Yes | Your Firewalla MSP ID, which is the full domain (e.g., company123.firewalla.net) | |
| FIREWALLA_MSP_TOKEN | Yes | Your Firewalla MSP access token generated in API settings |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_active_alarmsC | Retrieve current security alerts and alarms from Firewalla firewall |
| get_specific_alarmB | Get detailed information for a specific Firewalla alarm |
| get_flow_dataC | Query network traffic flows from Firewalla firewall |
| get_device_statusB | Check online/offline status of devices on Firewalla network |
| get_network_rulesB | Retrieve firewall rules and conditions |
| pause_ruleA | Temporarily disable an active firewall rule for a specified duration |
| resume_ruleB | Resume a previously paused firewall rule, restoring it to active state |
| get_target_listsB | Retrieve all target lists from Firewalla |
| get_specific_target_listC | Retrieve a specific target list by ID |
| create_target_listC | Create a new target list |
| update_target_listC | Update an existing target list |
| delete_target_listC | Delete a target list |
| search_flowsA | Search network flows with advanced query filters. Use this for: historical analysis, specific time ranges, complex filtering, or when you need more than 50 flows. Supports pagination, time-based queries (e.g., "ts:>1h" for last hour), and all flow fields including geographic filtering. For quick "what's happening now" snapshots, use get_recent_flow_activity instead. |
| search_alarmsA | Search alarms using full-text or field filters. Alarm types: 1=Security Activity, 2=Abnormal Upload, 3=Large Bandwidth Usage, 4=Monthly Data Plan, 5=New Device, 6=Device Back Online, 7=Device Offline, 8=Video Activity, 9=Gaming Activity, 10=Porn Activity, 11=VPN Activity, 12=VPN Connection Restored, 13=VPN Connection Error, 14=Open Port, 15=Internet Connectivity Update, 16=Large Upload. |
| search_rulesA | Search firewall rules by target, action or status. Supports all rule fields. |
| get_boxesC | Retrieve list of Firewalla boxes |
| get_simple_statisticsC | Retrieve basic statistics overview |
| get_statistics_by_regionC | Retrieve statistics by region (top regions by blocked flows) |
| get_statistics_by_boxB | Get statistics for each Firewalla box (top boxes by blocked flows or security alarms) |
| get_recent_flow_activityA | Get recent network flow activity snapshot (last 10-20 minutes). Returns up to 50 most recent flows for immediate analysis. CRITICAL: This is a quick snapshot tool only. Use this for: "what's happening right now?", current security threats, immediate network issues. DO NOT use for: historical analysis (use search_flows), getting more than 50 flows (use search_flows with limit), daily/weekly patterns (use search_flows with time queries like "ts:>24h"). For comprehensive analysis, always prefer search_flows. |
| get_flow_insightsA | Get category-based flow analysis including top content categories, bandwidth consumers, and blocked traffic. Ideal for answering questions like "what porn sites were accessed" or "what social media was used". Replaces time-based trends with actionable insights. |
| get_alarm_trendsB | Get historical alarm trend data (alarms generated per day) |
| get_rule_trendsC | Get historical rule trend data (rules created per day) |
| get_bandwidth_usageB | Get top bandwidth consuming devices (convenience wrapper around get_device_status) |
| get_offline_devicesB | Get all offline devices (convenience wrapper around get_device_status) |
| search_devicesA | Search devices by name, IP, MAC or status (convenience wrapper with client-side filtering) |
| search_target_listsA | Search target lists with client-side filtering (convenience wrapper around get_target_lists) |
| get_network_rules_summaryB | Get overview statistics and counts of network rules by category (convenience wrapper) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| security_report | Comprehensive security report for a time period |
| threat_analysis | Deep analysis of recent threats and blocked attempts |
| bandwidth_analysis | Top bandwidth consumers and usage patterns |
| device_investigation | Investigate a specific device: flows, alarms, behavior |
| network_health_check | Overall network health: summary, devices, metrics, topology, rules |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Firewall Summary | Real-time firewall health and performance metrics |
| Device Inventory | Complete device inventory with status and metadata |
| Security Metrics | Aggregated security statistics and trends |
| Network Topology | Network structure and device relationships |
| Recent Threats | Latest security events and blocked attempts |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/amittell/firewalla-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server