
ThreatLocker
io.github.WYRE-AIPublished by GitHub account WYRE-AIv1.4.2Updated Nov 21, 2026
MCP server for ThreatLocker — zero-trust endpoint protection, allowlisting, and policies.
Overview
Connects an assistant to the ThreatLocker Portal API to inspect computers, approval requests, audit logs and organizations for zero-trust endpoint protection.
- What you can do
- Navigate domains and check API connection status
- List and inspect computers, their checkin history, and computer groups
- List, inspect and count approval requests, including permit application details
- Search audit log entries, fetch single entries and view a file's audit history
- List child organizations, get an organization's installation auth key, and list organizations for computer moves
- When to use it
- Useful for security or IT admins who already run ThreatLocker and want to query endpoint inventory, pending approvals and audit history in natural language instead of clicking through the portal.
- Requirements
- Runs locally over stdio (Docker image or Node.js build from source). Needs a ThreatLocker API key in THREATLOCKER_API_KEY and an organization ID in THREATLOCKER_ORGANIZATION_ID, plus network access to the ThreatLocker API. Gateway/HTTP mode additionally needs AUTH_MODE=gateway and CONDUIT_S2S_SECRET, with credentials supplied per request via headers.
Installation
In SourceWeft
- Open ThreatLocker in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
ThreatLocker MCP Server
A Model Context Protocol (MCP) server that provides AI assistants with access to the ThreatLocker Portal API. Manage computers, approval requests, audit logs, and organizations through natural language interactions.
Features
- Stateless Architecture: No session state required, fresh connections per request
- Decision-Tree Navigation: Navigate domains with
threatlocker_navigate - Gateway Mode: Multi-tenant support via HTTP headers
- Elicitation Support: Interactive prompts for missing parameters
- Comprehensive Error Handling: Detailed error messages and logging
- Docker Support: Production-ready containerization
Tools
Navigation
threatlocker_navigate- Navigate to a domain to see available toolsthreatlocker_status- Check API connection status and available domains
Computers
threatlocker_computers_list- List computers with filters (search, group, pagination)threatlocker_computers_get- Get detailed computer informationthreatlocker_computers_get_checkins- Get computer checkin history
Computer Groups
threatlocker_computer_groups_list- List computer groups with filtersthreatlocker_computer_groups_dropdown- Get computer groups for dropdown selection
Approval Requests
threatlocker_approvals_list- List approval requests with status filtersthreatlocker_approvals_get- Get detailed approval request informationthreatlocker_approvals_pending_count- Get count of pending approvalsthreatlocker_approvals_get_permit_application- Get permit application details
Troubleshooting: if approval tools return an HTTP 401 / "Authentication failed" while audit tools work with the same key, the ThreatLocker API user/role lacks Approval Center permissions. An admin must grant them in the ThreatLocker portal; retrying will not help.
Audit Log
threatlocker_audit_search- Search audit log entries with filters.searchTextis a path filter (ThreatLockerfullPath), not free text: it matches the file path and also each row's process path and created-by path, so a program's path also finds what that program did. Give a full path or use*wildcards (*\setup.msi). Filter by computer withhostname. PasschildOrganizations: truefor computers in child organizations. Filter by result withactionId(1 Permit, 2 Deny, 3 Deny with option to request, 6 Ringfenced, 99 Any Deny;onlyTrueDenies/simulateDenysplit enforced from monitor-only denies) and byactionType(execute, install, network, ...).groupByscounts rows by one or two fields, soactionId: 2, groupBys: [6, 9]breaks denies down by policy name and action type. These filters need the SDK release that adds them; older SDKs send onlyactionTypethreatlocker_audit_get- Get one audit log entry; passeActionLogId,sourceTableIdandorganizationIdstraight from thethreatlocker_audit_searchrow (organizationIdis required for rows from child organizations; deprecated alias:actionLogId). HTTP 500 is reported as an actionable error: re-search and pass all three fields from the same rowthreatlocker_audit_file_history- Get audit history for a file. RequiresfullPathand eitherhostnameorcomputerId. For a computer in a child organization also passorganizationId(from itsthreatlocker_computers_listrow); without it the result is empty. Needs@wyre-ai/node-threatlockerwithgetFileHistory({ organizationId })support
Organizations
threatlocker_organizations_list_children- List child organizationsthreatlocker_organizations_get_auth_key- Get the installation auth key for the organization the configured credentials are scoped to. The result is a sensitive key and is never logged. Reports an explicit error instead of{}when ThreatLocker returns no JSON key, and returns text bodies with SDK 3.0.2threatlocker_organizations_for_move_computers- Get organizations for computer moves
Configuration
Environment Variables
Stdio Mode (Direct API Access)
Gateway Mode (Multi-tenant)
CONDUIT_S2S_SECRET is required for the HTTP transport. The process logs an error and exits non-zero when it is unset. For local development only, MCP_ALLOW_INSECURE_DEV=1 starts the server anyway and logs a loud warning; do not set that flag in production. The secret is never written to the logs.
When MCP_HTTP_HOST is unset, the server binds 127.0.0.1. The Dockerfile sets MCP_HTTP_HOST=0.0.0.0 so the process listens inside the container; publish that port on localhost.
Gateway Mode Headers
When running in gateway mode, include these headers with each request:
X-Gateway-S2S: Service-to-service proof from the gateway (t=<unix>,v1=<hmac>). Requests without a valid header are rejected with 401 whenCONDUIT_S2S_SECRETis set.X-Threatlocker-Api-Key: Your ThreatLocker API key (required). A request without it is rejected with 401 and does not fall back toTHREATLOCKER_API_KEY.X-Threatlocker-Organization-Id: Your organization ID (optional; the API defaults to the key's primary organization)
/health and /healthz stay unauthenticated and do not read credentials. The stdio transport does not use CONDUIT_S2S_SECRET.
Logging
Local Development
- Clone the repository:
- Install dependencies:
- Set environment variables:
- Build and run:
- Test the server:
Docker
Using Docker Compose
Using Docker directly
Architecture
Directory Structure
Design Patterns
- Domain Handlers: Each API area has its own handler with
getTools()andhandleCall() - Lazy Loading: Domain handlers are imported on-demand
- Fresh Connections: New server instance per HTTP request for stateless operation
- Credential Invalidation: Client is reset when credentials change
- Elicitation Framework: Interactive prompts for missing parameters
License
Apache-2.0 - see LICENSE for details.
Source: README.md at commit af389e2
Tools
0Version history
8- v1.4.2LatestNov 21, 2026
- v1.4.1Nov 14, 2026
- v1.4.0Nov 12, 2026
- v1.3.14Nov 11, 2026
- v1.3.12Oct 10, 2026
- v1.3.11Oct 9, 2026
- v1.3.10Sep 24, 2026
- v1.3.9Sep 16, 2026
Score
40% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.