Tools Reference

All available MCP Atlassian tools for Jira and Confluence

Tools Reference

MCP Atlassian provides tools for interacting with Jira and Confluence.

Key Tools

Jira Tools

Tool	Description
jira_get_issue	Get details of a specific issue
jira_search	Search issues using JQL
jira_create_issue	Create a new issue
jira_update_issue	Update an existing issue
jira_transition_issue	Transition issue to new status
jira_add_comment	Add a comment to an issue

Confluence Tools

Tool	Description
confluence_search	Search content using CQL
confluence_get_page	Get content of a specific page
confluence_create_page	Create a new page
confluence_update_page	Update an existing page
confluence_upload_attachment	Upload/update attachment on page
confluence_get_attachments	List attachments on content

Complete Tool List

Operation	Jira Tools	Confluence Tools
Read	jira_search	confluence_search
	jira_get_issue	confluence_get_page
	jira_get_all_projects	confluence_get_page_children
	jira_get_project_issues	confluence_get_comments
	jira_get_worklog	confluence_get_labels
	jira_get_transitions	confluence_search_user
	jira_search_fields	confluence_get_attachments
	jira_get_agile_boards	confluence_download_attachment
	jira_get_board_issues	confluence_download_content_attachments
	jira_get_sprints_from_board
	jira_get_sprint_issues
	jira_get_issue_link_types
	jira_batch_get_changelogs*
	jira_get_user_profile
	jira_download_attachments
	jira_get_project_versions
	jira_get_issue_development_info
	jira_get_issues_development_info
Write	jira_create_issue	confluence_create_page
	jira_update_issue	confluence_update_page
	jira_delete_issue	confluence_delete_page
	jira_batch_create_issues	confluence_add_label
	jira_add_comment	confluence_add_comment
	jira_transition_issue	confluence_upload_attachment
	jira_add_worklog	confluence_upload_attachments
	jira_link_to_epic	confluence_delete_attachment
	jira_create_sprint
	jira_update_sprint
	jira_create_issue_link
	jira_remove_issue_link
	jira_create_version
	jira_batch_create_versions

* jira_batch_get_changelogs is only available on Jira Cloud

Confluence Attachments

Media Type Filtering

When using confluence_get_attachments with the media_type parameter, be aware that the Confluence API returns application/octet-stream for most binary files (PNG, JPG, PDF) instead of specific MIME types like image/png.

Examples:

# This works - filter by generic binary type
media_type="application/octet-stream"  # Returns PNGs, JPGs, PDFs, etc.

# This returns 0 results - specific types not supported
media_type="image/png"  # Confluence doesn't return this type

# Better approach - filter by filename
filename="diagram.png"  # More reliable for specific files

Recommended Approach:

• Use the filename parameter for filtering specific files
• Use media_type="application/octet-stream" to get all binary attachments
• Check mediaTypeDescription field in results for human-readable type (e.g., “PNG Image”)

This is Confluence API behavior, not a limitation of this tool.

Tool Access Control

Enable Specific Tools

Use ENABLED_TOOLS environment variable or --enabled-tools flag:

# Environment variable
ENABLED_TOOLS="confluence_search,jira_get_issue,jira_search"

# Command line
uvx mcp-atlassian --enabled-tools "confluence_search,jira_get_issue,jira_search"

Read-Only Mode

Disable all write operations:

READ_ONLY_MODE=true

When enabled, only read operations are available regardless of ENABLED_TOOLS setting.