# Bmc Helix MCP

> Bmc Helix MCP is an open-source MCP server for developer tools. MCP server giving AI clients read access to BMC Helix ITSM forms, CMDB and change data. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, self-hosted
- **Repository:** https://github.com/rod-anami-kyndryl/bmc-helix-mcp
- **MCP Registry name:** io.github.rod-anami-kyndryl/bmc-helix-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [Api Testing MCP](https://ai-powered.com/mcp/api-testing-mcp): Api Testing MCP is an open-source MCP server for developer tools.
- [MCP Server](https://ai-powered.com/mcp/mcp-server-mweo0sk4): MCP Server is an MCP server for developer tools.
- [MCP Ticket Demo](https://ai-powered.com/mcp/mcp-ticket-demo): MCP Ticket Demo is an open-source MCP server for developer tools.
- [Happy Platform MCP](https://ai-powered.com/mcp/happy-platform-mcp): Happy Platform MCP is an open-source MCP server for developer tools.
- [Tickiti](https://ai-powered.com/mcp/tickiti): Tickiti is an open-source MCP server for developer tools.
- [Api Test MCP](https://ai-powered.com/mcp/api-test-mcp): Api Test MCP is an open-source MCP server for developer tools.
- [MCP Foundry — Build, Test & Publish MCP Servers](https://ai-powered.com/mcp/mcp-foundry-build-test-and-publish-mcp-servers): MCP Foundry — Build, Test & Publish MCP Servers is a freemium MCP server for developer tools.
- [Apollo MCP Server](https://ai-powered.com/mcp/apollo-mcp-server): Apollo MCP Server is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/bmc-helix-mcp
