jira-mini-mcp server

jira-mini-mcp

A Jira Cloud MCP server for coding agents: 6 read tools, 9 with writes enabled.

One job. One tool. Done right.

<!-- mcp-name: io.github.proprock/jira-mini-mcp -->

General-purpose Atlassian MCP servers expose dozens to hundreds of tools. Every one costs context before the agent does any useful work, and every near-duplicate makes the agent's choice less certain. This server gives a coding agent the Jira context it needs for a ticket, the three ways to answer back, and nothing else.

descriptions are tested so an agent picks the right one; see why so few and how it's compared with the alternatives.

• 6-9 tools, not 98 - every one earns its place in context, and the

Set READONLYMODE=true and they never register, not even as a disabled entry the agent can see.

• A write surface of exactly three tools - comment, transition, update.

text, no null spam, no self URLs, emails, or avatars; see what the tools return.

• Compact, predictable output - stable JSON schemas, Markdown for rich

in content, rather than again as structuredContent; set STRUCTURED_OUTPUT=true if your host needs the typed copy. See Cheaper output.

• Roughly 40% less output on the wire - each result is sent once, as JSON

cursor paging on search, and limit=0 to fetch the rest. A failed request is an error, never an empty list.

• Nothing is silently cut short - exact totals on comments and changelog,

transition and where it leads, so there is no separate discovery tool. Errors never contain your Jira URL, credentials, or raw response bodies.

• Errors an agent can act on - a wrong transition name lists every valid

through your own OAuth 2.0 app with automatic refresh; see Configure.

• API token or OAuth - one minute with an API token, or a browser login

clone or git URL required.

• On PyPI - uvx jira-mini-mcp or pip install jira-mini-mcp, no repo

Shortened. The full README is on GitHub.