Bmc Helix MCP
MCP server giving AI clients read access to BMC Helix ITSM forms, CMDB and change data
- Pricing
- Open source
- Platforms
- API, self-hosted
- Runs
- Remotely
- Version
- 0.1.1
- Listing updated
- today
Similar MCP servers
About Bmc Helix MCP
Bmc Helix MCP is an open-source MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.
The README says this server wraps BMC Helix ITSM REST endpoints so that an MCP-capable assistant can query tickets, forms and configuration items on a Helix instance. It is written in TypeScript on Express and exposes its tools over streamable HTTP, with optional HTTPS and a bearer token in front of the endpoint.
The registered tools cover table lookups with filters and automatic pagination, CMDB queries by ID or name, change request tasks, the problem linked to an incident, and the configuration items attached to a change. Connection details such as the Helix API URL, JWT login URL, user credentials and TLS certificate paths are supplied through environment variables, and the README includes a helper script for retrieving a Helix certificate chain.
The project is aimed at SRE and ITSM teams who already run BMC Helix and want an assistant to pull change and incident context during operations work. It is MIT licensed and has an integration test suite that runs against a mock Helix server.
Install
Run in a terminal
claude mcp add bmc-helix-mcp --env HELIX_API_URL='<HELIX_API_URL>' --env HELIX_TOKEN_URL='<HELIX_TOKEN_URL>' --env HELIX_USERID='<HELIX_USERID>' --env HELIX_PASSWORD='<HELIX_PASSWORD>' --env MCP_AUTH_TOKEN='<MCP_AUTH_TOKEN>' -- npx -y bmc-helix-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"bmc-helix-mcp": {
"command": "npx",
"args": [
"-y",
"bmc-helix-mcp"
],
"env": {
"HELIX_API_URL": "<HELIX_API_URL>",
"HELIX_TOKEN_URL": "<HELIX_TOKEN_URL>",
"HELIX_USERID": "<HELIX_USERID>",
"HELIX_PASSWORD": "<HELIX_PASSWORD>",
"MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"bmc-helix-mcp": {
"command": "npx",
"args": [
"-y",
"bmc-helix-mcp"
],
"env": {
"HELIX_API_URL": "<HELIX_API_URL>",
"HELIX_TOKEN_URL": "<HELIX_TOKEN_URL>",
"HELIX_USERID": "<HELIX_USERID>",
"HELIX_PASSWORD": "<HELIX_PASSWORD>",
"MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"bmc-helix-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"bmc-helix-mcp"
],
"env": {
"HELIX_API_URL": "<HELIX_API_URL>",
"HELIX_TOKEN_URL": "<HELIX_TOKEN_URL>",
"HELIX_USERID": "<HELIX_USERID>",
"HELIX_PASSWORD": "<HELIX_PASSWORD>",
"MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"bmc-helix-mcp": {
"command": "npx",
"args": [
"-y",
"bmc-helix-mcp"
],
"env": {
"HELIX_API_URL": "<HELIX_API_URL>",
"HELIX_TOKEN_URL": "<HELIX_TOKEN_URL>",
"HELIX_USERID": "<HELIX_USERID>",
"HELIX_PASSWORD": "<HELIX_PASSWORD>",
"MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"bmc-helix-mcp": {
"command": "npx",
"args": [
"-y",
"bmc-helix-mcp"
],
"env": {
"HELIX_API_URL": "<HELIX_API_URL>",
"HELIX_TOKEN_URL": "<HELIX_TOKEN_URL>",
"HELIX_USERID": "<HELIX_USERID>",
"HELIX_PASSWORD": "<HELIX_PASSWORD>",
"MCP_AUTH_TOKEN": "<MCP_AUTH_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
HELIX_API_URLBMC Helix Entry level REST API URL endpoint.RequiredHELIX_TOKEN_URLBMC Helix JWT Login endpoint URL.RequiredHELIX_USERIDBMC Helix API Username/UserID.RequiredHELIX_PASSWORDBMC Helix API User Password.RequiredHELIX_CERT_PATHPath to the retrieved BMC Helix TLS certificate chain.MCP_PORTThe port number on which the MCP Server should run.MCP_AUTH_TOKENOptional Bearer token to secure the MCP Server communication.MCP_TLS_ENABLEDSet to true to run the MCP Server with secure TLS (HTTPS).MCP_TLS_KEYPath to the TLS private key file.MCP_TLS_CERTPath to the TLS certificate file.MCP_TLS_CAPath to the TLS Certificate Authority (CA) file.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- helix_get_table_data
- Retrieve records from any BMC Helix form with optional query filters and record limits.
- helix_get_table_data_paginated
- Automatically fetches and aggregates multi-page records from a form using offset-based pagination.
- helix_get_ci_by_id
- Get a configuration item's attributes from BMC.CORE:BMC_BaseElement by its unique entry Request ID.
- helix_get_ci_by_name
- Find CMDB records by name.
- helix_get_change_request_tasks
- Retrieves children task lists from TMS:Task for a given Change ID.
- helix_get_problem_investigation_id
- Finds the associated Problem ID for a given incident ticket.
- helix_get_change_configuration_items
- Finds AST configuration items associated with a Change ID.
What it does
- Form record retrieval
- Fetches records from any BMC Helix form with optional query filters and record limits.
- Paginated table aggregation
- Collects records across multiple pages using offset-based pagination.
- CMDB configuration item lookup
- Finds configuration items in BMC.CORE:BMC_BaseElement by request ID or name.
- Change and problem relationships
- Lists change tasks, linked configuration items and the problem associated with an incident.
- Optional TLS and bearer auth
- Runs over HTTPS with certificate settings and an optional bearer token on the MCP endpoint.
Good for
- Let an assistant pull incident details from a Helix ITSM instance during triage
- Review tasks and configuration items attached to a change request before rollout
- Trace the problem record behind a recurring incident
- Query CMDB entries by name or ID while investigating an outage
Pricing
Open source
Free and MIT licensed; requires an existing BMC Helix instance.
Bmc Helix MCP FAQ
Which BMC Helix API does it use?
The README says it wraps the native BMC Helix ITSM REST API calls, with the entry-level endpoint and a JWT login URL configured through environment variables.
What license is it under?
The README states that the project is licensed under the MIT License.
Can the MCP endpoint be secured?
Yes. The MCP_AUTH_TOKEN variable is an optional bearer token for the MCP endpoint, and HTTPS can be enabled with MCP_TLS_ENABLED.
Is Bmc Helix MCP free?
Yes. Bmc Helix MCP is open source, so you can use and self-host it for free.
How do I add Bmc Helix MCP to Claude Code?
Run this command in your terminal: claude mcp add bmc-helix-mcp --env HELIX_API_URL='<HELIX_API_URL>' --env HELIX_TOKEN_URL='<HELIX_TOKEN_URL>' --env HELIX_USERID='<HELIX_USERID>' --env HELIX_PASSWORD='<HELIX_PASSWORD>' --env MCP_AUTH_TOKEN='<MCP_AUTH_TOKEN>' -- npx -y bmc-helix-mcp
What are the best alternatives to Bmc Helix MCP?
The closest alternatives to Bmc Helix MCP are Api Testing MCP, MCP Server, MCP Ticket Demo, Happy Platform MCP and Tickiti.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.