MCP servers 2026-09-19 10:20 UTC
mcp-atlassian
Committed by ulikoenig. Update Category: Bug Fixes & Stability Improvements. Commit details: fix(jira): sort DEFAULT_READ_JIRA_FIELDS before joining into tool schemas (#1685). This update resolves known runtime errors and enhances system reliability.
CommitRaw commit message
fix(jira): sort DEFAULT_READ_JIRA_FIELDS before joining into tool schemas (#1685) * fix(jira): sort DEFAULT_READ_JIRA_FIELDS before joining into tool schemas get_issue, search, get_board_issues and get_sprint_issues each build the default value of their "fields" parameter with ",".join(DEFAULT_READ_JIRA_FIELDS). DEFAULT_READ_JIRA_FIELDS is a set, so its iteration order depends on the interpreter's (randomised) hash seed. Two worker processes running the exact same code therefore advertise two different tool schemas for the same tool, purely because they happen to have different hash seeds. This is externally visible: an MCP client that fingerprints/caches the tool catalog can see the schema "change" between two calls that land on different workers of the same deployment, even though nothing about the tool changed. Observed in the wild against a stateless, multi-worker deployment: GitHub Copilot CLI aborted a jira_search call with a "tool catalog changed" error, while Claude Code tolerated the same drift. Fixes #1662. Sort the fields before joining at every call site (the four tool signatures in servers/jira.py, plus the two runtime fallbacks in jira/issues.py and jira/search.py) so the emitted string is deterministic across processes and hash seeds. DEFAULT_READ_JIRA_FIELDS itself stays a set (equality/membership checks elsewhere rely on that), only the string serialization is now sorted. Added a regression test that spawns fresh interpreters under several PYTHONHASHSEED values and asserts all four affected tools report the same "fields" default - this fails on main (each seed can produce a different order) and passes with the fix. * test(jira): cover deterministic runtime defaults Reported-by: ulikoenig --------- Co-authored-by: mcp-atlassian-maintainer[bot] <300134992+mcp-atlassian-maintainer[bot]@users.noreply.github.com>