Skip to content
Back to search

falcon-mcp

Connect AI agents to CrowdStrike Falcon for automated security analysis and threat hunting

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/CrowdStrike/falcon-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/CrowdStrike/falcon-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/crowdstrike--falcon-mcp/badge.svg)](/listings/crowdstrike--falcon-mcp)

HTML

<a href="/listings/crowdstrike--falcon-mcp"><img src="/api/listings/crowdstrike--falcon-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install

Using uv (recommended)

uv tool install falcon-mcp

Using pip

pip install falcon-mcp

Configure

Set the required environment variables (or use a `.env` file — see the [Configuration Guide](https://developer.crowdstrike.com/falcon-mcp/getting-started/configuration/)):

export FALCON_CLIENT_ID="your-client-id"
export FALCON_CLIENT_SECRET="your-client-secret"
export FALCON_BASE_URL="https://api.crowdstrike.com"

Run

falcon-mcp

See the [Getting Started guide](https://developer.crowdstrike.com/falcon-mcp/getting-started/installation/) for full installation and configuration details.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 333 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ![CrowdStrike Logo (Light)](https://raw.githubusercontent.com/CrowdStrike/.github/main/assets/cs-logo-light-mode.png#gh-light-mode-only)
  2. ![CrowdStrike Logo (Dark)](https://raw.githubusercontent.com/CrowdStrike/.github/main/assets/cs-logo-dark-mode.png#gh-dark-mode-only)
  3. <!-- mcp-name: io.github.CrowdStrike/falcon-mcp -->
  4. # falcon-mcp
  5. [![PyPI version](https://badge.fury.io/py/falcon-mcp.svg)](https://badge.fury.io/py/falcon-mcp)
  6. [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/falcon-mcp)](https://pypi.org/project/falcon-mcp/)
  7. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  8. [![MCP Registry](https://img.shields.io/badge/MCP_Registry-falcon--mcp-blue)](https://registry.modelcontextprotocol.io/?q=io.github.CrowdStrike%2Ffalcon-mcp&all=1)
  9. [![GitHub MCP](https://img.shields.io/badge/GitHub_MCP-falcon--mcp-blue?logo=github)](https://github.com/mcp/CrowdStrike/falcon-mcp)
  10. [![Gemini CLI Extension](https://img.shields.io/badge/Gemini_CLI-falcon--mcp-blue?logo=google)](https://geminicli.com/extensions/?name=CrowdStrikefalcon-mcp)
  11. **falcon-mcp** is a Model Context Protocol (MCP) server that connects AI agents with the CrowdStrike Falcon platform, powering intelligent security analysis in your agentic workflows. It delivers programmatic access to essential security capabilities—including detections, threat intelligence, and host management—establishing the foundation for advanced security operations and automation.
  12. > [!IMPORTANT]
  13. > **falcon-mcp is now in maintenance mode.** Development continues in [CrowdStrike MCP](https://docs.crowdstrike.com/r/en-US/pclqa2q2/tefc5682), CrowdStrike's hosted MCP server, and we recommend moving to it. falcon-mcp stays supported and will keep getting security fixes, but new features will only ship in CrowdStrike MCP. See [Moving to CrowdStrike MCP](#moving-to-crowdstrike-mcp) for what this means for you.
  14. ## Documentation
  15. Full docs are available at **[developer.crowdstrike.com/falcon-mcp](https://developer.crowdstrike.com/falcon-mcp/)**.
  16. ## Moving to CrowdStrike MCP
  17. falcon-mcp started as an open source project to work out how AI agents should use Falcon. A lot of what we built here, including fixes and ideas from your issues and pull requests, carries forward into [CrowdStrike MCP](https://docs.crowdstrike.com/r/en-US/pclqa2q2/tefc5682). CrowdStrike MCP is a CrowdStrike product rather than an open source project, so new development won't happen in this repository. Thanks to everyone who filed issues and sent pull requests.
  18. For most teams, CrowdStrike MCP is the better choice now:
  19. - It runs inside the Falcon platform, so there's nothing to install, host, or upgrade.
  20. - Most tools keep the same `falcon_*` names, so prompts and agent instructions written for falcon-mcp carry over.
  21. - Tool access follows the Falcon roles and permissions you already manage, and activity is recorded in the Falcon audit log.
  22. - New tools and improvements ship there.
  23. What happens to falcon-mcp:
  24. - The same CrowdStrike team that builds CrowdStrike MCP maintains it, and it's supported through the same channels.
  25. - Existing installs keep working. Future releases carry security and dependency fixes only.
  26. - We're no longer accepting feature requests or feature pull requests.
  27. - CrowdStrike MCP is available in US-1, US-2, and EU-1. If your tenant is in another cloud, or you depend on a tool that only falcon-mcp has (see [Differences from CrowdStrike MCP](https://developer.crowdstrike.com/falcon-mcp/modules/overview/#differences-from-crowdstrike-mcp)), keep using falcon-mcp for now.
  28. - We'll announce an end-of-life date here before the repository is archived.
  29. ## Modules
  30. | Module | Description |
  31. | ------ | ----------- |
  32. | Core | Basic connectivity and system information |
  33. | [AgentWorks](https://developer.crowdstrike.com/falcon-mcp/modules/agentworks/) | Call, list, and observe Charlotte AI agents and their execution traces |
  34. | [Case Management](https://developer.crowdstrike.com/falcon-mcp/modules/cases/) | Case lifecycle management, evidence attachment, tagging, and templates |
  35. | [Cloud Security](https://developer.crowdstrike.com/falcon-mcp/modules/cloud/) | Kubernetes containers, image vulnerabilities, CSPM asset inventory, IOM findings, suppression rules, cloud risks, cloud insights, and cloud groups |
  36. | [Correlation Rules](https://developer.crowdstrike.com/falcon-mcp/modules/correlationrules/) | Search, create, update, and manage NG-SIEM correlation rules |
  37. | [Custom IOA](https://developer.crowdstrike.com/falcon-mcp/modules/custom-ioa/) | Create and manage Custom IOA behavioral detection rules and rule groups |
  38. | [Data Security](https://developer.crowdstrike.com/falcon-mcp/modules/data-security/) | Search, create, and update Data Security classifications, policies, content patterns, applications, web locations, sensitivity labels, and file types |
  39. | [Detections](https://developer.crowdstrike.com/falcon-mcp/modules/detections/) | Find, aggregate, and analyze detections to understand malicious activity |
  40. | [Discover](https://developer.crowdstrike.com/falcon-mcp/modules/discover/) | Search application inventory and managed/unmanaged assets, including drive encryption and system-insights posture |
  41. | [Exclusions](https://developer.crowdstrike.com/falcon-mcp/modules/exclusions/) | Search, create, update, and delete IOA, machine learning, sensor visibility, and certificate-based exclusions |
  42. | [Firewall Management](https://developer.crowdstrike.com/falcon-mcp/modules/firewall/) | Search and manage firewall rules and rule groups |
  43. | [Fusion SOAR](https://developer.crowdstrike.com/falcon-mcp/modules/fusion/) | Search Fusion SOAR workflow definitions and executions, read execution results, and run on-demand workflows |
  44. | [Guardian](https://developer.crowdstrike.com/falcon-mcp/modules/guardian/) | Monitor AI agent activity, sessions, tool usage, and inventory |
  45. | [Host Groups](https://developer.crowdstrike.com/falcon-mcp/modules/host-groups/) | Search, create, update, and delete host groups; manage group membership |
  46. | [Hosts](https://developer.crowdstrike.com/falcon-mcp/modules/hosts/) | Manage and query host/device information |
  47. | [Identity Protection](https://developer.crowdstrike.com/falcon-mcp/modules/idp/) | Entity investigation and identity protection analysis |
  48. | [Intel](https://developer.crowdstrike.com/falcon-mcp/modules/intel/) | Research threat actors, IOCs, and intelligence reports |
  49. | [IOC](https://developer.crowdstrike.com/falcon-mcp/modules/ioc/) | Search, create, and remove custom indicators of compromise |
  50. | [NGSIEM](https://developer.crowdstrike.com/falcon-mcp/modules/ngsiem/) | Execute CQL queries against Next-Gen SIEM |
  51. | [Policies](https://developer.crowdstrike.com/falcon-mcp/modules/policies/) | Search, create, update, and delete prevention, sensor update, firewall, device control, response, and content update policies; manage host-group assignment, enable/disable, and precedence |
  52. | [Quarantine](https://developer.crowdstrike.com/falcon-mcp/modules/quarantine/) | Search quarantine records, preview action counts, and release, unrelease, or delete quarantined files |
  53. | [Real Time Response](https://developer.crowdstrike.com/falcon-mcp/modules/rtr/) | Audit, summarize, and run read-only RTR triage workflows |
  54. | [Recon](https://developer.crowdstrike.com/falcon-mcp/modules/recon/) | Search and aggregate Falcon Intelligence Recon notifications (recon alerts), monitoring rules, and exposed-data records for dark web, leaked credentials, and typosquatting, and preview prospective rule noise |
  55. | [Scheduled Reports](https://developer.crowdstrike.com/falcon-mcp/modules/scheduled-reports/) | Manage scheduled reports and download report files |
  56. | [Sensor Usage](https://developer.crowdstrike.com/falcon-mcp/modules/sensor-usage/) | Access and analyze sensor usage data |
  57. | [Serverless](https://developer.crowdstrike.com/falcon-mcp/modules/serverless/) | Search for vulnerabilities in serverless functions |
  58. | [Shield](https://developer.crowdstrike.com/falcon-mcp/modules/shield/) | SaaS security posture, checks, alerts, and app inventory |
  59. | [Spotlight](https://developer.crowdstrike.com/falcon-mcp/modules/spotlight/) | Manage and analyze vulnerability data and security assessments |
  60. | [Zero Trust Assessment](https://developer.crowdstrike.com/falcon-mcp/modules/zero-trust-assessment/) | Retrieve Zero Trust Assessment posture scores and sensor and OS hardening signals for hosts |
  61. See the [Module Overview](https://developer.crowdstrike.com/falcon-mcp/modules/overview/) for required API scopes, available tools, and FQL resources.
  62. > [!NOTE]
  63. > The Guardian module reads the `/aidr` API, whose route and parameter surface is not
  64. > yet uniform across Falcon deployments. Some tools return HTTP 400 or 404 where an
  65. > older surface is live. See the [Guardian module docs](https://developer.crowdstrike.com/falcon-mcp/modules/guardian/) for the details.
  66. ## Quick Start
  67. ### Install
  68. #### Using uv (recommended)
  69. ```bash
  70. uv tool install falcon-mcp
  71. ```
  72. #### Using pip
  73. ```bash
  74. pip install falcon-mcp
  75. ```
  76. ### Configure
  77. Set the required environment variables (or use a `.env` file — see the [Configuration Guide](https://developer.crowdstrike.com/falcon-mcp/getting-started/configuration/)):
  78. ```bash
  79. export FALCON_CLIENT_ID="your-client-id"
  80. export FALCON_CLIENT_SECRET="your-client-secret"
  81. export FALCON_BASE_URL="https://api.crowdstrike.com"
  82. ```
  83. ### Run
  84. ```bash
  85. falcon-mcp
  86. ```
  87. See the [Getting Started guide](https://developer.crowdstrike.com/falcon-mcp/getting-started/installation/) for full installation and configuration details.
  88. ## Editor Integration
  89. ### Using `uvx` (recommended)
  90. ```json
  91. {
  92. "mcpServers": {
  93. "falcon-mcp": {
  94. "command": "uvx",
  95. "args": [
  96. "--env-file",
  97. "/path/to/.env",
  98. "falcon-mcp"
  99. ]
  100. }
  101. }
  102. }
  103. ```
  104. ### With Module Selection
  105. ```json
  106. {
  107. "mcpServers": {
  108. "falcon-mcp": {
  109. "command": "uvx",
  110. "args": [
  111. "--env-file",
  112. "/path/to/.env",
  113. "falcon-mcp",
  114. "--modules",
  115. "detections,hosts,intel"
  116. ]
  117. }
  118. }
  119. }
  120. ```
  121. ### Docker
  122. ```json
  123. {
  124. "mcpServers": {
  125. "falcon-mcp-docker": {
  126. "command": "docker",
  127. "args": [
  128. "run",
  129. "-i",
  130. "--rm",
  131. "--env-file",
  132. "/full/path/to/.env",
  133. "quay.io/crowdstrike/falcon-mcp:latest"
  134. ]
  135. }
  136. }
  137. }
  138. ```
  139. See the [Usage guide](https://developer.crowdstrike.com/falcon-mcp/usage/cli/) for all command line options, module configuration, and library usage.
  140. ## Container Usage
  141. ```bash
  142. # Pull the latest image
  143. docker pull quay.io/crowdstrike/falcon-mcp:latest
  144. # Run with .env file (stdio transport)
  145. docker run -i --rm --env-file /path/to/.env quay.io/crowdstrike/falcon-mcp:latest
  146. # Run with streamable-http transport (add --api-key when the port is reachable beyond localhost)
  147. docker run --rm -p 8000:8000 --env-file /path/to/.env \
  148. quay.io/crowdstrike/falcon-mcp:latest \
  149. --transport streamable-http --host 0.0.0.0 --api-key your-secret-key
  150. ```
  151. > [!CAUTION]
  152. > HTTP transports have no authentication by default. Binding to a non-loopback address (`--host 0.0.0.0`)
  153. > exposes an unauthenticated server that anyone who can reach the port can drive with your CrowdStrike
  154. > credentials. Keep the default loopback bind for local use and set `--api-key` whenever you bind wider.
  155. > Managed runtimes such as AWS Bedrock AgentCore and Google Cloud Run sit behind their own network
  156. > security layer, so this does not apply to them. See the
  157. > [Configuration guide](https://developer.crowdstrike.com/falcon-mcp/getting-started/configuration/#http-transport-security).
  158. See the [Docker Deployment guide](https://developer.crowdstrike.com/falcon-mcp/deployment/docker/) for building locally, custom ports, and advanced configurations.
  159. ## Dynamic Mode
  160. Running many modules at once inflates the context window every AI client must hold. Dynamic mode
  161. replaces the full tool surface with three tools — `falcon_list_enabled_tools` to see every tool the
  162. server has available, `falcon_search_tools` to find candidate tools by keyword and then fetch the parameter
  163. schema for the one you pick, and `falcon_execute_tool` to run it — so agents only load the schemas
  164. they actually need.
  165. ```bash
  166. falcon-mcp --dynamic
  167. # or: FALCON_MCP_DYNAMIC=true
  168. ```
  169. See the [Dynamic Mode guide](https://developer.crowdstrike.com/falcon-mcp/usage/dynamic-mode/) for
  170. the full discover → execute workflow and trade-offs.
  171. ## Restricting What a Server Can Do
  172. `--modules` is all-or-nothing per module: enabling one to get its search tools also exposes every
  173. mutating tool it carries. Three tool-level options narrow that surface.
  174. ```bash
  175. # Investigation-only server: no tool that mutates tenant state is registered
  176. falcon-mcp --read-only
  177. # Expose exactly two tools, nothing else
  178. falcon-mcp --tools falcon_search_detections,falcon_search_hosts
  179. # Keep the module, drop one tool
  180. falcon-mcp --modules hostgroups --exclude-tools falcon_delete_host_groups
  181. # All of detections, plus one tool from a module you did not enable
  182. falcon-mcp --modules detections --tools falcon_search_applications
  183. ```
  184. | Flag | Environment Variable | Effect |
  185. | --- | --- | --- |
  186. | `--read-only` | `FALCON_MCP_READ_ONLY` | Registers only read-only tools |
  187. | `--tools` | `FALCON_MCP_TOOLS` | Allow-list of tool names, added to the enabled modules |
  188. | `--exclude-tools` | `FALCON_MCP_EXCLUDE_TOOLS` | Deny-list of tool names |
  189. Tool names are the `falcon_`-prefixed names your client displays. An unrecognized name aborts
  190. startup rather than being ignored, so a typo in a deny-list cannot silently leave a tool exposed.
  191. ### Composing the options
  192. `--tools` is **additive**, not a narrowing filter. It grants individual tools on top of whatever
  193. `--modules` already enabled, reaching across the module boundary:
  194. - `--tools X` on its own registers **only** X — no modules are loaded by default.
  195. - `--modules detections --tools X` registers every `detections` tool **plus** X, even when X
  196. belongs to a module that is not enabled. That module contributes only X, not its whole surface,
  197. and `falcon_list_enabled_modules` does not list it. `falcon_list_enabled_tools` does list X — it
  198. reports the tools available on the server, so it is the reliable answer to "is this capability
  199. available here?"
  200. To *subtract*, use `--exclude-tools` or `--read-only`. All four knobs compose, and they resolve in
  201. a fixed order:
  202. 1. `--exclude-tools` removes a tool unconditionally, even if `--tools` names it.
  203. 2. `--read-only` removes every mutating tool unconditionally, even if `--tools` names it.
  204. 3. `--tools` adds the tools it names, bypassing the module gate.
  205. 4. `--modules` decides which tools are candidates by default.
  206. Because the first two rules always win, `--read-only` and `--exclude-tools` are safe to set as a
  207. deployment-wide floor: an additive `--tools` list cannot widen past them. Combining them is how you
  208. express "search everything, change nothing, and don't even offer that one tool":
  209. ```bash
  210. falcon-mcp --read-only --exclude-tools falcon_execute_rtr_read_only_command
  211. ```
  212. Filtering applies to dynamic mode too — a withheld tool is absent from `falcon_search_tools`
  213. results and rejected by `falcon_execute_tool`. Because dynamic mode dispatches by name rather than
  214. registering tools individually, that rejection spells out that the tool exists but the server's
  215. configuration withholds it, and names the one rule responsible, so an agent reports a disabled tool
  216. as disabled instead of telling the user the capability does not exist.
  217. `falcon_list_enabled_tools` carries a `filters_active` field in either mode whenever a rule is in
  218. effect. The startup log reports which rules are active and how many tools `--read-only` and
  219. `--exclude-tools` withheld, so you can confirm what you deployed. Run with `--debug` to see the
  220. withheld tools by name.
  221. These options filter tools, not resources. A withheld tool's FQL guide resource stays available —
  222. guides are static field documentation carrying no tenant data.
  223. ## Deployment Options
  224. - [Amazon Bedrock AgentCore](https://developer.crowdstrike.com/falcon-mcp/deployment/amazon-bedrock/)
  225. - [Google Cloud (Agent Platform / Gemini Enterprise)](./examples/adk/README.md)
  226. ## Contributing
  227. falcon-mcp is in maintenance mode and no longer accepts new features or modules. We still review security and dependency fixes. To report a vulnerability, follow the [security policy](.github/SECURITY.md).
  228. ```bash
  229. # Clone and install
  230. git clone https://github.com/CrowdStrike/falcon-mcp.git
  231. cd falcon-mcp
  232. uv sync --all-extras
  233. # Run tests
  234. uv run pytest
  235. ```
  236. > [!IMPORTANT]
  237. > This project uses [Conventional Commits](https://www.conventionalcommits.org/) for automated releases. Please follow the commit message format outlined in our [Contributing Guide](.github/CONTRIBUTING.md).
  238. ### Developer Documentation
  239. - [Documentation Guide](docs/development/docs-site.md): Architecture and maintenance guide for the documentation
  240. - [Module Development Guide](docs/development/module-development.md): Instructions for implementing new modules
  241. - [Resource Development Guide](docs/development/resource-development.md): Instructions for implementing resources
  242. - [Integration Testing Guide](docs/development/integration-testing.md): Guide for running integration tests with real API calls
  243. ## Registries
  244. falcon-mcp is published to public MCP catalogs for discovery and one-click setup in compatible clients:
  245. - [MCP Registry](https://registry.modelcontextprotocol.io/?q=io.github.CrowdStrike%2Ffalcon-mcp&all=1)
  246. - [GitHub MCP Registry](https://github.com/mcp/CrowdStrike/falcon-mcp)
  247. - [Gemini CLI Extensions](https://geminicli.com/extensions/?name=CrowdStrikefalcon-mcp)
  248. ## License
  249. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  250. ## Support
  251. falcon-mcp is maintained by the CrowdStrike team that builds [CrowdStrike MCP](https://docs.crowdstrike.com/r/en-US/pclqa2q2/tefc5682) and is supported through the same channels. It's in maintenance mode, so fixes are limited to security and dependency issues.
  252. For more information, please see our [SUPPORT](SUPPORT.md) file.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.