fortra-fim-mcp
This server provides a local stdio MCP interface for interacting with the Tripwire Enterprise REST API, primarily focused on File Integrity Monitoring (FIM) workflows. It exposes the following tools:
te_get_status: Retrieve the current status of the Tripwire Enterprise API and server.
te_list_nodes / te_get_node: Search and list monitored nodes with filters (name, paging, etc.), or fetch a specific node by ID.
te_get_policy_test_results / te_get_policy_test_result: Query policy compliance test results filtered by node, state, policy test name, etc., or fetch a single result by ID.
te_list_versions / te_get_version: Search element versions with filters (node ID, rule name, promotion status, severity range), or get a specific version by ID.
Allowlist results across four categories:
te_list_allowlist_software_resultste_list_allowlist_open_port_resultste_list_allowlist_user_resultste_list_allowlist_service_results
te_promote_versions: Submit a promotion request for one or more element versions (with approval ID, comment, and custom property type).
te_get_promote_request: Check the status of a previously submitted promotion request.
te_api_request: Make raw GET, POST, PUT, DELETE, or PATCH requests to any Tripwire Enterprise API endpoint under
/api/v1.
Additional features:
Most list tools accept a
filtersobject mapping to Tripwire query parameters (e.g.,name,nodeId,state,pageLimit,pageStart).All tools support a
rawflag to return full Tripwire JSON or a condensed, MCP-friendly summary with acount.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fortra-fim-mcp list nodes with name containing 'prod'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
fim-mcp
Local stdio MCP server for the Tripwire Enterprise REST API.
The first version wraps the core FIM workflows:
list and fetch nodes
get policy test results
list and fetch element versions
explore allowlist software, open port, user, and service results
promote element versions
check promote request status
make a raw Tripwire API request for uncovered endpoints
Setup
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e .
Copy-Item .env.example .envEdit .env:
TE_HOST=https://TECONSOLEHOST/api
TE_USERNAME=administrator
TE_API_TOKEN=replace-with-token
TE_VERIFY_SSL=false
TE_TIMEOUT=30TE_HOST may point at either the API root (https://server/api) or the versioned API root (https://server/api/v1).
Related MCP server: ConnectWise API Gateway MCP Server
Run
python -m fim_mcpFor MCP clients that need a command:
{
"mcpServers": {
"fim-mcp": {
"command": "python",
"args": ["-m", "fim_mcp"],
"env": {
"TE_HOST": "https://TECONSOLEHOST/api",
"TE_USERNAME": "administrator",
"TE_API_TOKEN": "replace-with-token",
"TE_VERIFY_SSL": "false"
}
}
}
}If your Python user scripts directory is on PATH, the installed fim-mcp command works too.
Use with Codex
Codex reads MCP server definitions from config.toml in your Codex home directory. On Windows this is usually:
C:\Users\<you>\.codex\config.tomlAfter running the setup steps above, add this to that file. Use the full path to the virtual environment Python for the repo:
[mcp_servers.fim-mcp]
command = 'C:\path\to\fim-mcp\.venv\Scripts\python.exe'
args = ['-m', 'fim_mcp']
startup_timeout_sec = 30
[mcp_servers.fim-mcp.env]
TE_HOST = 'https://TECONSOLEHOST/api'
TE_USERNAME = 'administrator'
TE_API_TOKEN = 'replace-with-token'
TE_VERIFY_SSL = 'false'
TE_TIMEOUT = '30'For this checkout, the command path would look like:
command = 'C:\Users\chris\Downloads\vibes\te mcp\.venv\Scripts\python.exe'If you install the package somewhere already on PATH, you can use the console script instead:
[mcp_servers.fim-mcp]
command = 'fim-mcp'
args = []
startup_timeout_sec = 30
[mcp_servers.fim-mcp.env]
TE_HOST = 'https://TECONSOLEHOST/api'
TE_USERNAME = 'administrator'
TE_API_TOKEN = 'replace-with-token'
TE_VERIFY_SSL = 'false'
TE_TIMEOUT = '30'Restart Codex, or start a new Codex session, after editing config.toml. To verify the server is available, ask Codex to list Tripwire Enterprise nodes or call te_get_status. If the server starts correctly, Codex will have access to the te_* tools listed below.
Tools
te_get_statuste_list_nodeste_get_nodete_get_policy_test_resultste_get_policy_test_resultte_list_versionste_get_versionte_list_allowlist_software_resultste_list_allowlist_open_port_resultste_list_allowlist_user_resultste_list_allowlist_service_resultste_promote_versionste_get_promote_requestte_api_request
Most list tools accept a filters object. The keys map directly to Tripwire Enterprise query parameters, so filters such as name, sub_name, nodeId, state, pageLimit, and pageStart can be passed without code changes.
Set raw: true on wrapped tools to return the Tripwire JSON unchanged. The default response returns a smaller MCP-friendly summary plus a count.
Available Tools
10 toolste_api_requestB
Call any Tripwire Enterprise API endpoint under /api/v1.
Inputs: path (required), method (required), body, query.
te_get_nodeB
Get one Tripwire node by readable-key node ID.
Inputs: node_id (required), raw.
te_get_policy_test_resultB
Get one policy test result by readable-key result ID.
Inputs: result_id (required), raw.
te_get_policy_test_resultsC
Search policy test results. Use filters for nodeId, state, policyTestName, paging, and other API parameters.
Inputs: raw, latest, filters.
te_get_promote_requestC
Get status for a Tripwire element version promotion request.
Inputs: request_id (required), raw.
te_get_statusC
Get Tripwire Enterprise API and server status.
Inputs: raw.
te_get_versionB
Get one element version by readable-key version ID.
Inputs: version_id (required), raw.
te_list_nodesC
Search Tripwire nodes. Pass Tripwire query parameters in filters.
Inputs: raw, filters, summaries.
te_list_versionsC
Search element versions. Use filters for nodeId, ruleName, isPromoted, severityRange, paging, and other API parameters.
Inputs: raw, latest, filters.
te_promote_versionsC
Submit a Tripwire element version promotion request.
Inputs: comment (required), approval_id (required), version_ids (required), custom_property_type_id (required), +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool targets a distinct resource (nodes, versions, policy tests, promotions, status) with clear actions (get, list, promote). The generic te_api_request is a fallback for uncovered endpoints, not overlapping with specific tools.
All tools use the consistent 'te_verb_noun' pattern in snake_case, with verbs like get, list, promote. No mixing of conventions.
10 tools is well-scoped for a Tripwire Enterprise integration, covering core operations without excess or deficiency.
The toolset covers the main lifecycle (list/get nodes and versions, view policy test results, manage promotions) and the generic API endpoint fills any remaining gaps, ensuring no dead ends.
Maintenance
Related MCP Connectors
Authenticated MCP server for ClearPolicy policy and compliance workflows.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
MCP server for CertScore.ai public website risk-signal workflows.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for Shannon Lite security workflows, enabling configuration, scan orchestration, workspace management, and report reading.111MIT
- FlicenseNot gradedqualityDmaintenanceThis MCP server simplifies interaction with the ConnectWise Manage API through API discovery, execution, and a fast memory system for efficient workflows.-
- AlicenseAqualityDmaintenanceMCP server for the tastytrade brokerage API, providing tools for account management, market data, and order execution.18MIT
- AlicenseAqualityBmaintenanceMCP server for interacting with the ThreatLocker Portal API, enabling querying of computers, applications, policies, audit logs, and more through AI assistants.183GPL 3.0