Skip to main content
Glama
solomonneas

rapid7-mcp

by solomonneas

Rapid7 InsightIDR MCP Server

TypeScript 5.7 Node.js MCP SDK Rapid7 License: MIT

A Model Context Protocol (MCP) server that provides AI assistants with access to Rapid7 InsightIDR, a cloud-native SIEM for modern detection and response. Query investigations, search logs with LEQL, analyze alerts, track assets, monitor user behavior, and manage threat intelligence.

Features

Investigations

  • Search and filter investigations by status, priority, assignee, date range

  • Create, update, and manage investigation lifecycle

  • Add comments and retrieve associated alerts

  • Build investigation timelines

Log Search (LEQL)

  • Execute LEQL (Log Entry Query Language) queries across log sets

  • List available log sets (Firewall, DNS, DHCP, Endpoint, Cloud, Active Directory)

  • Retrieve individual log entries and aggregate statistics

  • LEQL syntax reference and examples

Alerts

  • List and filter alerts by severity, type, status, date

  • Get full alert details with evidence and indicators

  • Update alert status (open, investigating, closed)

  • Evidence extraction for investigation

Assets

  • Search endpoints by hostname, IP, OS, agent status

  • Full asset details: software inventory, vulnerabilities, agent info

  • Recent activity: logins, processes, network connections

User Behavior Analytics (UBA)

  • Search user accounts across the organization

  • Activity analysis: login patterns, locations, accessed assets

  • Risky user identification with behavior scoring

  • Anomaly detection and alert correlation

Threat Intelligence

  • IOC management: IPs, domains, file hashes

  • Add indicators to threat library

  • Search for threat indicator matches across logs

Saved Queries

  • List and manage saved LEQL queries

  • Create reusable queries with descriptions

  • LEQL syntax helper with examples

Related MCP server: Megaraptor MCP

Architecture

┌────────────────────────────────────────┐
│           MCP Client (LLM)             │
└──────────────┬─────────────────────────┘
               │ MCP Protocol (stdio)
┌──────────────▼─────────────────────────┐
│         rapid7-mcp server              │
│                                        │
│  ┌──────────┐  ┌────────────────────┐  │
│  │ Prompts  │  │    Resources       │  │
│  │ 4 guides │  │ templates, LEQL,   │  │
│  │          │  │ detection rules    │  │
│  └──────────┘  └────────────────────┘  │
│                                        │
│  ┌──────────────────────────────────┐  │
│  │            Tools                  │  │
│  │  investigations │ logs │ alerts   │  │
│  │  assets │ users │ threats│queries │  │
│  └──────────────┬───────────────────┘  │
│                 │                       │
│  ┌──────────────▼───────────────────┐  │
│  │      InsightIDR REST Client      │  │
│  │      (client.ts + config.ts)     │  │
│  └──────────────┬───────────────────┘  │
└──────────────────┼─────────────────────┘
                   │ HTTPS
┌──────────────────▼─────────────────────┐
│      Rapid7 InsightIDR Platform API    │
│      https://<region>.api.insight.rapid7│
└────────────────────────────────────────┘

Installation

git clone https://github.com/solomonneas/rapid7-mcp.git
cd rapid7-mcp
npm install
npm run build

Configuration

Set environment variables:

export RAPID7_API_KEY="your-api-key"
export RAPID7_REGION="us"          # us, eu, ca, au, ap
export RAPID7_ORG_ID="your-org-id" # optional

Or use a .env file:

RAPID7_API_KEY=your-api-key
RAPID7_REGION=us
RAPID7_ORG_ID=your-org-id

MCP Client Configuration

Claude Desktop

{
  "mcpServers": {
    "rapid7": {
      "command": "node",
      "args": ["path/to/rapid7-mcp/dist/index.js"],
      "env": {
        "RAPID7_API_KEY": "your-api-key",
        "RAPID7_REGION": "us"
      }
    }
  }
}

OpenClaw

Add to your openclaw.json:

{
  "mcp": {
    "servers": {
      "rapid7": {
        "type": "stdio",
        "command": "node",
        "args": ["/path/to/rapid7-mcp/dist/index.js"],
        "env": {
          "RAPID7_API_KEY": "your-api-key",
          "RAPID7_REGION": "us"
        }
      }
    }
  }
}

Tool Reference

Tool

Description

search_investigations

List/filter investigations by status, priority, assignee

get_investigation

Get full investigation details with timeline

create_investigation

Create new investigation

update_investigation

Update status, assignee, disposition

add_investigation_comment

Add comment/note to investigation

get_investigation_alerts

Get alerts linked to an investigation

search_logs

Execute LEQL queries against log sets

list_log_sets

List available log sets

get_log_entry

Get specific log entry by ID

get_log_stats

Aggregate statistics for a time range

list_alerts

Get alerts with severity/type/status filters

get_alert

Full alert details with evidence

update_alert_status

Update alert status

get_alert_evidence

Get evidence/indicators from an alert

search_assets

Search endpoints by hostname, IP, OS

get_asset

Full asset details with software/vulns

get_asset_activity

Recent activity for an asset

search_users

Search user accounts

get_user_activity

User behavior analytics

get_risky_users

Users with abnormal behavior scores

list_threat_indicators

List IOCs in threat library

add_threat_indicator

Add new IOC

search_threat_activity

Search for IOC matches in logs

list_saved_queries

List saved LEQL queries

create_saved_query

Save a LEQL query for reuse

leql_help

LEQL syntax reference and examples

LEQL Query Examples

-- Find all blocked traffic from a source
where(source_address = 10.0.0.1 AND action = BLOCK)

-- Top talkers by connection count
groupby(source_address) calculate(count) sort(desc)

-- Failed logins for a specific user
where(user = "admin" AND result = FAILED_LOGIN)

-- HTTP errors by URL
where(status >= 400) groupby(url) calculate(count)

-- DNS queries to suspicious domains
where(query CONTAINS "malware") groupby(query) calculate(count)

-- Outbound connections on non-standard ports
where(destination_port != 80 AND destination_port != 443 AND direction = OUTBOUND)

Prompts

Prompt

Description

investigate-alert

Guided alert investigation workflow

hunt-ioc

Search for IOC across all log sources

user-behavior-review

Analyze user activity for anomalies

incident-timeline

Build chronological incident timeline

Resources

URI

Description

rapid7://investigation-templates

Common investigation templates

rapid7://leql-reference

LEQL syntax and examples

rapid7://detection-rules

Built-in detection rule catalog

Development

npm run build    # Compile TypeScript
npm run dev      # Watch mode
npm run test     # Run tests
npm run lint     # Lint check

License

MIT

Install Server
A
license - permissive license
A
quality
F
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    B
    maintenance
    Connects AI assistants to the Vectra AI security platform to enable intelligent analysis of threat detection data and automated incident response workflows. It allows users to investigate threats, take response actions, and generate security reports using natural language.
    Last updated
    23
    5
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to interact with the Velociraptor digital forensics and incident response platform for endpoint management and threat hunting. It supports artifact collection, VQL query execution, and automated forensic investigation workflows.
    Last updated
    35
    3
    MIT
  • F
    license
    -
    quality
    D
    maintenance
    Enables querying Rapid7 InsightIDR logs using natural language through AI assistants, with support for time filtering, logset selection, and LEQL queries.
    Last updated
    5
  • A
    license
    C
    quality
    B
    maintenance
    Enables AI assistants to interact with the ReliaQuest GreyMatter platform via 146 tools across 22 domains for incident response, playbooks, cases, and more, including a generic graphql_query escape hatch.
    Last updated
    100
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Search your knowledge bases from any AI assistant using hybrid RAG.

  • Real-time threat intel for AI agents: 890K+ IOCs incl. prompt-injection & AI-skill threats

  • Search companies, enrich contacts, and reveal emails and phones from your AI agent.

View all MCP Connectors

Latest Blog Posts

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/solomonneas/rapid7-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server