skills.rest
jwvdvuurst
jwvdvuurstCOMMUNITY
Explore all skills by this author →
GitHub

-onprem-atlassian-mcp

Operate on-prem Jira and Confluence instances through a local MCP server.

Updated Dec 26, 2025
Search Tags:#mcp#issue tracking#jira#atlassian#jql#confluence#on-prem
One-click install
npx skills add https://github.com/jwvdvuurst/CalculatorCollection --skill onprem-atlassian-mcp-jwvdvuurst
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: -onprem-atlassian-mcp
Source: https://github.com/jwvdvuurst/CalculatorCollection/tree/main/skills/atlassian-onprem-mcp
Command: npx skills add https://github.com/jwvdvuurst/CalculatorCollection --skill onprem-atlassian-mcp-jwvdvuurst

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with on-prem Atlassian Jira and Confluence through an MCP server requires correct instance routing, workflow-safe transitions, and base64 attachment handling, which agents often get wrong by assuming Atlassian Cloud behavior. ## Core Features & Use Cases - Jira Issue Operations: Search with JQL, create, update, comment on, transition, and link issues across EMEA and global Jira instances with automatic project-key routing. - Confluence Page Management: Search, read, create, update, label, and attach files to Confluence pages using storage-format content. - Attachments and Linking: Upload and download Jira and Confluence attachments via base64 payloads and create Jira remote links to Confluence pages. - Use Case: A user asks to move issue OPS-123 to "Reviewed" and attach a generated report; the skill first lists available transitions, then performs the transition and uploads the base64-encoded file to the correct Jira instance. ## Quick Start Ask the agent to search Jira for open issues in your project and transition one of them to the next workflow state using the on-prem Atlassian MCP.

Frequently Asked Questions about -onprem-atlassian-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I transition a Jira issue to a new workflow state?▼

Call jira_get_transitions first to discover available transitions for the issue, then use jira_transition_issue with the transition name or ID. If you also need to change the assignee, use jira_update_issue_state_or_assignee to perform both in one call.

How do I attach a file to a Jira issue through the MCP server?▼

Base64-encode the file content locally and send it with jira_add_attachment. To retrieve files, list them with jira_list_attachments and download content with jira_download_attachment, which returns base64 data.

How does routing between EMEA and global Jira instances work?▼

Routing uses the instance parameter set to emea, global, or auto. In auto mode, the project key derived from the issue key determines the instance, with keys like WIN4, OPS, and LBS routed to EMEA and all others to global.

Can I link a Jira issue to a Confluence page?▼

Yes, use jira_link_confluence_page with the issueKey and Confluence pageId to create a Jira remote link. Remove it later with jira_unlink_confluence_page using either the remoteLinkId or the pageId.

Does this skill work with Atlassian Cloud instances?▼

No, it targets on-prem Jira Server or Data Center and Confluence through a local MCP server. Cloud-specific assumptions like account IDs being always present should be avoided; use assigneeName for server-style usernames.

Why does my Jira JQL search fail on the on-prem server?▼

Some on-prem Jira instances reject special JQL helpers or long GET queries. Use jira_search_issues_jql, which can fall back from GET to POST, and keep JQL plain while paging with startAt and maxResults.

Related Skills

Explore More Software Engineering Skills→
sunyonghuansunyonghuan
46

mcp

Validate MCP server configurations for stdio, sse, or streamable-http transports.

Community
Intermediate
ryan-nguyen-01ryan-nguyen-01
4

agent-pm

Coordinate product delivery from backlog to release with structured templates.

Community
Advanced
son-nguyen-301son-nguyen-301

read-jira

Fetch Jira issue details from a URL or key.

Community
Intermediate
shomatanshomatan
3

confluence-adf-edit

Edit existing Confluence pages via REST v2 and ADF diff-based updates.

Community
Advanced