Skip to main content
Glama
rrvrs

jira-alerts-mcp

Get JSM alert details

jsm_get_alert
Read-onlyIdempotent

Retrieve complete JSM alert details, including description, custom fields, responders, tags, and dedupe count, by ID or alias. Use after listing alerts to access the full payload.

Instructions

Retrieve the full detail of a single JSM alert, including its description, custom details/extraProperties, responders, tags and dedupe count.

Use this after jsm_list_alerts when you need the payload an integration attached to the alert (host, service, metric values, runbook links) — the list endpoint returns a thinner record without the description or details map.

Args:

  • identifier (string): the full alert id, or an alias when identifier_type='alias'

  • identifier_type ('id' | 'alias'): default 'id'

  • response_format ('markdown' | 'json'): default 'markdown'

Returns (json format): a single alert object with id, tinyId, message, description, status, acknowledged, snoozed, priority, source, owner, tags, responders, details (custom key/value map), extraProperties, count, createdAt, updatedAt, lastOccurredAt, and a report block with acknowledgedBy/closedBy. Responder ids are resolved to names where the credentials allow it.

Examples:

  • "What does alert #4821 actually say?" -> resolve the id via jsm_list_alerts, then call with identifier=

  • "Look up the alert our pipeline created with alias 'redis-latency-prod'" -> identifier="redis-latency-prod", identifier_type="alias"

Error handling:

  • HTTP 404 usually means a tinyId was passed instead of the full id. Resolve it with jsm_list_alerts first.

  • Aliases only resolve against OPEN alerts; a closed alert must be fetched by id.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
identifierYesThe alert's full id, or its alias if identifier_type='alias'. The short tinyId from the UI is NOT accepted by the API — search with jsm_list_alerts to resolve a tinyId to a full id.
identifier_typeNoWhich identifier was supplied. 'id' hits /v1/alerts/{id}; 'alias' hits the separate /v1/alerts/alias endpoint.id
response_formatNoOutput format. 'markdown' is compact and human-readable (default); 'json' returns every field for programmatic use.markdown

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
alertYes

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. First observedv1.1.1

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already mark the tool as read-only and idempotent, and the description adds substantial behavioral context: it documents that responder ids are resolved to names when credentials allow, that a 404 usually means a tinyId was passed, and that alias lookup only works for open alerts. This goes well beyond the structured annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is long but every section earns its place: a scoped purpose statement, usage guidance, parameter summary, return expectations, examples, and error handling. It is front-loaded with the most important information and structured with clear labels, making it easy to scan.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with three parameters, a rich return shape, and potential error traps, the description covers everything an agent needs: when to use it, what parameters mean, what the response contains, how to handle the likely 404, and two concrete example queries. The output schema further covers return fields, so nothing critical is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the schema already documents all three parameters thoroughly. The description adds extra value with worked examples for id-based and alias-based lookups, clarifies the tinyId limitation, and explains the difference between identifier and alias endpoints, which helps the agent choose values correctly.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Retrieve') with a clear resource ('a single JSM alert') and enumerates the included fields (description, custom details/extraProperties, responders, tags, dedupe count). It explicitly contrasts the output with the thinner jsm_list_alerts record, so an agent can distinguish it from sibling tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly states when to use this tool ('after jsm_list_alerts when you need the payload an integration attached') and when the list endpoint is sufficient. Error handling notes clarify that tinyIds are rejected and aliases only resolve against open alerts, guiding correct invocation and recovery.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/rrvrs/jira-alerts-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server