Bmc Helix MCP server
io.github.rod-anami-kyndryl/bmc-helix-mcp·v0.1.1A MCP Server for BMC Helix ITSM API.
0 stars36 downloads/wk
Reviews
Write oneNobody has reviewed Bmc Helix yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Bmc Helix tools (7)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
helix_get_change_configuration_itemsExplore change relationships to find all impacted Configuration Items associated with a Change Request.
helix_get_change_request_tasksFetch SRE change request tasks from TMS:Task associated with a specific Change (CRQ ID).
helix_get_ci_by_idRetrieve a specific CI from BMC Helix CMDB BMC.CORE:BMC_BaseElement by its unique entry Request ID.
helix_get_ci_by_nameRetrieve CMDB CI records from BMC.CORE:BMC_BaseElement that match a given name.
helix_get_problem_investigation_idExplore incident relationships to locate the related Problem Investigation ID from HPD:Associations.
helix_get_table_dataFetch SRE data elements from a BMC Helix form in a single rate-limited request with filters and limit.
helix_get_table_data_paginatedFetch all matching data elements from a BMC Helix form using offset-based pagination until all pages are retrieved.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan8 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 9 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
How Bmc Helix compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 80/100
- higher than 60% of 48,255 servers
- Tools
- 7
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 36
- more than 26% of 12,191 servers with a package
What its tools let an agent do: 7 read
Install Bmc Helix in Claude Code, Cursor or VS Code
Runs npx -y bmc-helix-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add bmc-helix-mcp -- npx -y bmc-helix-mcp
What the publisher says
From the Bmc Helix repository's README, as published. We do not edit it. Read it on GitHub
BMC Helix MCP Server
The BMC Helix MCP Server is a Model Context Protocol (MCP) server for SRE operations using BMC Helix ITSM REST APIs. It is implemented in TypeScript, powered by Express, and optionally configurable with HTTPS/TLS.
For details on releases and updates, see the Changelog.
Project Features
- Model Context Protocol (MCP) Support: Built with @modelcontextprotocol/sdk to seamlessly integrate with LLMs and coding assistants.
- Form & CI Operations: Wraps native BMC Helix ITSM REST API calls for fetching and paginating table data, CMDB CI querying by ID or Name, tasks, associations, and relationship checking.
- Express + HTTPS: Supports standard HTTP as well as secure HTTPS with complete TLS certificate validation configurations.
- Node v24 and modern ES Module structure.
Directory Structure
- src/mcp-server.ts: Fully-typed, rate-limited MCP Server application featuring express transport and tool mappings.
- certs/: Holds local client and server CA keys, configurations, and scripts for secure TLS enablement.
- tests/: Integration tests using a mock Helix Server to validate server endpoints, authorization, and tool schemas.
Registered MCP Tools
The server registers the following high-value tools:
- helixgettabledata**: Retrieve records from any BMC Helix form (e.g., HPD:IncidentInterface, CHG:Infrastructure Change) with optional query filters and record limits.
- helixgettabledatapaginated: Automatically fetches and aggregates multi-page records from a form using offset-based pagination.
- helixgetcibyid: Get a configuration item's attributes from BMC.CORE:BMC_BaseElement by its unique entry Request ID.
- helixgetcibyname: Find CMDB records by name.
- helixgetchangerequesttasks: Retrieves children task lists from TMS:Task for a given Change ID (CRQ...).
- helixgetprobleminvestigationid: Finds the associated Problem ID for a given incident ticket.
- helixgetchangeconfigurationitems: Finds AST configuration items associated with a Change ID.
Installation & Setup
- Copy .env.example to .env and fill in your details:
cp .env.example .env- Configuration Settings in .env:
- HELIXAPIURL: BMC Helix Entry level URL endpoint.
- HELIXTOKENURL: JWT Login payload URL endpoint.
- HELIXUSERID / HELIXPASSWORD: Helix API Credentials.
- MCP_PORT: Web server running port (defaults to 3000).
- MCPAUTHTOKEN: Optional API Authorization Bearer token to secure the MCP endpoint from external entities.
- MCPTLSENABLED: Set to true to enable TLS on the express listener.
- Retrieve TLS Certificates from BMC Helix:
If your BMC Helix instance uses self-signed, internal, or custom CA certificates, you can automatically retrieve the certificate chain using the helper script:
./certs/helix-certs.sh https://your-helix-instance.onbmc.comThis retrieves the website's certificate chain via openssl and saves it to certs/helix-certs.pem. Then, reference it in your .env configuration:
HELIX_CERT_PATH=./certs/helix-certs.pem- Install dependencies:
npm install- Build the application:
npm run build- Start the server (Dev / Production):
- Production Mode: npm run start
- Development Mode: npm run dev
Testing
The project includes an integration test suite implemented with Node's native test runner (via --test). It runs against a mock BMC Helix server environment to validate:
- Server initialization & health status checks.
- API authentication and security authorization filters (e.g., verifying MCPAUTHTOKEN behavior).
- Tool definitions and structural query capability.
- Exact end-to-end flow execution for tool retrievals (helixgettabledata, helixgettabledata_paginated, CI queries, and Change/Problem relationships).
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Bmc Helix: common questions
- Is Bmc Helix MCP server safe?
- Mostly: it is graded B (80/100). Read the Bmc Helix safety report
- How do I install Bmc Helix?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Bmc Helix need an API key?
- Yes. The registry entry asks for
HELIX_PASSWORD,MCP_AUTH_TOKEN. - Is Bmc Helix maintained?
- The last commit was 49 days ago (2026-09-16). The latest release is v0.1.1.
- How does Bmc Helix compare with other MCP servers?
- safety score 80/100 (higher than 60% of 48,255 servers); tools 7 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.