Binalyze AIR MCP Server

Official

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables querying and managing Linux-based endpoints in the Binalyze AIR forensics platform through natural language interactions.

  • Allows for management and forensic analysis of macOS endpoints within the Binalyze AIR platform through natural language queries.

  • Serves as the runtime environment for the MCP server, allowing the server to connect Binalyze AIR's digital forensics capabilities with language models.

Binalyze AIR MCP Server

A Node.js server implementing Model Context Protocol (MCP) for Binalyze AIR, enabling natural language interaction with AIR's digital forensics and incident response capabilities.

✨ Features

  • Asset Management - List assets in your organization.
  • Acquisition Profiles - List acquisition profiles.
  • Organization Management - List organizations.
  • Case Management - List cases in your organization.
  • Policy Management - See security policies across your organization.
  • Task Management - Track forensic collection tasks and their statuses.
  • Triage Rules - View YARA, Osquery and Sigma rules for threat detection.
  • User Management - List users in your organization.
  • Drone Analyzers - View available drone analyzers with supported operating systems.

Overview

This MCP server creates a bridge between Large Language Models (LLMs) and Binalyze AIR, allowing interaction through natural language. Retrieve information about your digital forensics environment without writing code or learning complex APIs.

🔑 API Token Requirement

Important: An API token is required for authentication. Set it using the AIR_API_TOKEN environment variable.

📦 Installation

Local Development

# Clone the repository git clone https://github.com/binalyze/air-mcp # Change to the project directory cd air-mcp # Install dependencies npm install # Build the project npm run build

Usage with Claude Desktop

Add the following configuration to your Claude Desktop config file:

{ "mcpServers": { "air-mcp": { "command": "npx", "args": ["-y", "@binalyze/air-mcp"], "env": { "AIR_HOST": "your-api-host.com", "AIR_API_TOKEN": "your-api-token" } } } }

Usage with Cursor

  1. Navigate to Cursor Settings > MCP
  2. Add new MCP server with the following configuration:
    { "mcpServers": { "air-mcp": { "command": "npx", "args": ["-y", "@binalyze/air-mcp"], "env": { "AIR_HOST": "your-api-host.com", "AIR_API_TOKEN": "your-api-token" } } } }

🧩 Usage with Smithery

Note: Don't forget to activate Agent mode in your editor.

One-Line Installation Commands

Claude

npx -y @smithery/cli@latest install @binalyze/air-mcp --client claude --key {smithery_key}

Cursor

npx -y @smithery/cli@latest install @binalyze/air-mcp --client cursor --key {smithery_key}

Windsurf

npx -y @smithery/cli@latest install@rapidappio/rapidapp-mcp --client windsurf --key {smithery_key}

VSCode

npx -y @smithery/cli@latest install @binalyze/air-mcp --client vscode --key {smithery_key}

Or use the Magic Link option in VSCode.

How to Use

In Claude Desktop, or any MCP Client, you can use natural language commands:

CommandDescription
List all assets in the systemShows all managed/unmanaged endpoints with OS, platform info
List all acquisition profilesDisplays available acquisition profiles
List all organizationsShows all organizations in environments
List all casesDisplays cases with status and creation time
List all policiesShows security and collection policies
List all tasksLists all tasks with their statuses
List all triage rulesShows YARA, OSQuery and Sigma rules for threat detection
List all usersShows all users in the system with their details
List all drone analyzersShows available drone analyzers with supported operating systems

Filtering by Organization

You can filter results by organization ID:

List all assets for organization 123 Show me all cases for organization 456 Get policies for organization 789 List tasks for organization 123 List triage rules for organization 123 List users for organization 123

Response Example

Found 3 assets: a1b2c3d4: Win10-Workstation1 (Windows - Windows 10 Pro) e5f6g7h8: Ubuntu-Server1 (Linux - Ubuntu 20.04) i9j0k1l2: MacBook-Pro (macOS - macOS 12.3)

Found 3 triage rules: corewebshell_detection: core.webshell_detection (Engine: yara, Search In: both) fireeye-sunburst-countermeasures: FireEye Sunburst Countermeasures (Engine: yara, Search In: both) fireeye-red-team-tools-countermeasures: FireEye Red Team Tools Countermeasures (Engine: yara, Search In: both)

Found 1 user: DtmrCWrK1o7m0bqVasdzg6Ia: demo@binalyze.com (demo@binalyze.com)

Found 20 drone analyzers: bha: Browser History Analyzer (Supported OS: Windows, Default Enabled: Yes) wsa: Generic WebShell Analyzer (Supported OS: Windows, Linux, macOS, Default Enabled: Yes)

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

A Node.js server implementing Model Context Protocol (MCP) that enables natural language interaction with Binalyze AIR's digital forensics and incident response capabilities.

  1. ✨ Features
    1. Overview
      1. 🔑 API Token Requirement
    2. 📦 Installation
      1. Local Development
      2. Usage with Claude Desktop
      3. Usage with Cursor
    3. 🧩 Usage with Smithery
      1. One-Line Installation Commands
    4. How to Use
      1. Filtering by Organization
    5. Response Example
      ID: 5adqp7j7ru