# Jira Alerts (JSM Operations)

> Jira Alerts (JSM Operations) is an open-source MCP server for productivity. Search and acknowledge Jira Service Management alerts and see who is on call. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/rrvrs/jira-alerts-mcp
- **MCP Registry name:** io.github.rrvrs/jira-alerts-mcp
- **Categories:** productivity, developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-16

## About

Opsgenie's alerting moved into Jira Service Management Operations, and the author says no other Jira MCP server covers that surface. This one lets an assistant search alerts, read their notes and activity timeline, acknowledge or close them, add notes and responders, and look up who is on call now and next.

A demo in the README shows the agent confirming that an acknowledgement actually landed instead of assuming success, since the underlying writes are asynchronous. Tools are grouped into toolsets: the default responder set registers 28 tools, while JSM_TOOLSETS=all adds schedules, teams, maintenance windows and routing for 82. A read-only switch withholds every write tool.

It needs Node 24 or later, your Atlassian cloud ID and an API token or OAuth token, and runs over stdio or HTTP. A first check is asking for open alerts, which exercises jsm_list_alerts, then asking who is on call to try schedules, which needs a separate scope.

## Features

- **Alert search:** Find open alerts and read notes and timelines.
- **Acknowledge and close:** Write tools to acknowledge, close and annotate alerts.
- **On-call lookup:** See who is on call now and next.
- **Toolset selection:** Choose a narrow default or register all verified toolsets.
- **Read-only mode:** One setting withholds every write tool.
- **Write confirmation:** The agent checks that asynchronous writes landed.

## Good for

- Ask what is paging you right now
- Acknowledge alerts you have already handled
- Find the current on-call responder
- Review an alert's activity timeline during an incident

## Install

### Claude Code (Terminal)

```sh
claude mcp add jira-alerts-mcp --env JSM_CLOUD_ID='<JSM_CLOUD_ID>' --env JSM_API_TOKEN='<JSM_API_TOKEN>' --env JSM_OAUTH_TOKEN='<JSM_OAUTH_TOKEN>' -- npx -y jira-alerts-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "jira-alerts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "jira-alerts-mcp"
      ],
      "env": {
        "JSM_CLOUD_ID": "<JSM_CLOUD_ID>",
        "JSM_API_TOKEN": "<JSM_API_TOKEN>",
        "JSM_OAUTH_TOKEN": "<JSM_OAUTH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "jira-alerts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "jira-alerts-mcp"
      ],
      "env": {
        "JSM_CLOUD_ID": "<JSM_CLOUD_ID>",
        "JSM_API_TOKEN": "<JSM_API_TOKEN>",
        "JSM_OAUTH_TOKEN": "<JSM_OAUTH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "jira-alerts-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "jira-alerts-mcp"
      ],
      "env": {
        "JSM_CLOUD_ID": "<JSM_CLOUD_ID>",
        "JSM_API_TOKEN": "<JSM_API_TOKEN>",
        "JSM_OAUTH_TOKEN": "<JSM_OAUTH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "jira-alerts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "jira-alerts-mcp"
      ],
      "env": {
        "JSM_CLOUD_ID": "<JSM_CLOUD_ID>",
        "JSM_API_TOKEN": "<JSM_API_TOKEN>",
        "JSM_OAUTH_TOKEN": "<JSM_OAUTH_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "jira-alerts-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "jira-alerts-mcp"
      ],
      "env": {
        "JSM_CLOUD_ID": "<JSM_CLOUD_ID>",
        "JSM_API_TOKEN": "<JSM_API_TOKEN>",
        "JSM_OAUTH_TOKEN": "<JSM_OAUTH_TOKEN>"
      }
    }
  }
}
```

## Tools

- `jsm_list_alerts`: List alerts without needing ids.
- `jsm_list_schedules`: List on-call schedules.

## FAQ

### Which Jira product does it target?

Jira Service Management Operations, the alert surface that replaced Opsgenie.

### What does it need?

Node 24 or later, your Atlassian cloud ID and an API token or OAuth token.

### Can I stop it making changes?

Yes, set JSM_READ_ONLY to true.

### Why does the schedules check fail with 401?

Schedules need a separate read:ops-config scope.

### Is Jira Alerts (JSM Operations) free?

Yes. Jira Alerts (JSM Operations) is open source, so you can use and self-host it for free.

### How do I add Jira Alerts (JSM Operations) to Claude Code?

Run this command in your terminal: claude mcp add jira-alerts-mcp --env JSM_CLOUD_ID='<JSM_CLOUD_ID>' --env JSM_API_TOKEN='<JSM_API_TOKEN>' --env JSM_OAUTH_TOKEN='<JSM_OAUTH_TOKEN>' -- npx -y jira-alerts-mcp

### What are the best alternatives to Jira Alerts (JSM Operations)?

The closest alternatives to Jira Alerts (JSM Operations) are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/jira-alerts-jsm-operations
