Skip to main content
Glama
fortra-fim-mcp

fortra-fim-mcp

by askjarv

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 .env

Edit .env:

TE_HOST=https://TECONSOLEHOST/api
TE_USERNAME=administrator
TE_API_TOKEN=replace-with-token
TE_VERIFY_SSL=false
TE_TIMEOUT=30

TE_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_mcp

For 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.toml

After 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_status

  • te_list_nodes

  • te_get_node

  • te_get_policy_test_results

  • te_get_policy_test_result

  • te_list_versions

  • te_get_version

  • te_list_allowlist_software_results

  • te_list_allowlist_open_port_results

  • te_list_allowlist_user_results

  • te_list_allowlist_service_results

  • te_promote_versions

  • te_get_promote_request

  • te_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 tools
te_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

    B3.3/5.0

    Scored across 10 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools use the consistent 'te_verb_noun' pattern in snake_case, with verbs like get, list, promote. No mixing of conventions.

    Tool Count5/5

    10 tools is well-scoped for a Tripwire Enterprise integration, covering core operations without excess or deficiency.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for the tastytrade brokerage API, providing tools for account management, market data, and order execution.
      18
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for interacting with the ThreatLocker Portal API, enabling querying of computers, applications, policies, audit logs, and more through AI assistants.
      18
      3
      GPL 3.0