atlassian-mcp

Read, create, and update Jira issues and Confluence pages via the Atlassian MCP server.

3|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/OktayCopurlu/ai-shared --skill atlassian-mcp-oktaycopurlu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: atlassian-mcp
Source: https://github.com/OktayCopurlu/ai-shared/tree/main/.github/workflows/skills/atlassian-mcp
Command: npx skills add https://github.com/OktayCopurlu/ai-shared --skill atlassian-mcp-oktaycopurlu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually opening Jira tickets or Confluence pages in a browser and pasting content into a conversation is slow and error-prone. This Skill lets the AI fetch and modify Atlassian resources directly through MCP tools, using exact issue keys, page IDs, or URLs. ## Core Features & Use Cases - Jira Issue Operations: Fetch issues by key (e.g., DSC-1986), search with JQL, transition issues, assign users, and add comments. - Confluence Page Operations: Read, create, and update Confluence pages, including pages referenced by tiny-link IDs, with CQL search support. - Attachment Viewing: Download Jira image attachments via curl with basic auth and inspect them locally. - Use Case: A user pastes a Jira ticket key like DSC-2209 and asks for a summary; the Skill fetches the issue directly with the Jira issue tool instead of opening a browser. ## Quick Start Ask the AI to fetch and summarize Jira ticket DSC-1986 using the Atlassian MCP tools.

Frequently Asked Questions about atlassian-mcp

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

FAQPage Schema
How do I read a Jira ticket with the Atlassian MCP server?▼

Fetch the issue directly with the Jira issue fetch tool, passing the exact key such as DSC-2209 as issueIdOrKey. Do not open the URL in a browser or use Confluence page tools for Jira issue bodies.

How do I search Jira issues with JQL via MCP?▼

Use the JQL search tool only when you need precise filtering that generic search cannot express. Keep queries small by default with maxResults or limit set to 10, and prefer the generic search tool for open-ended discovery.

Can the Atlassian MCP tools view Jira image attachments?▼

The MCP tools cannot download attachment files directly. Fetch the ticket to get the attachment download URL, then download it with curl using basic auth with your Jira email and API token, and view the file locally.

How do I transition a Jira issue to a new status via MCP?▼

Call the transition-list tool first to retrieve valid transition IDs for the issue, then invoke the transition operation with the correct ID. Transition IDs vary per workflow, so never guess them.

What should I do when the MCP tool names differ from the documentation?▼

Map the intended operation, such as Jira fetch, Confluence fetch, search, or transition, to whatever namespaced or renamed tools the current session exposes. Tool surfaces drift between MCP hosts, so match by intent rather than exact function names.