---
title: "Tools Reference"
description: "All available MCP Atlassian tools for Jira and Confluence"
---

# Tools Reference

MCP Atlassian provides tools for interacting with Jira and Confluence.

## Key Tools

<CardGroup cols={2}>
  <Card title="Jira Tools" icon="list-check">
    | 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 |
  </Card>
  <Card title="Confluence Tools" icon="book">
    | 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 |
  </Card>
</CardGroup>

## 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` | |

<Note>
\* `jira_batch_get_changelogs` is only available on Jira Cloud
</Note>

## 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:**

```python
# 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:

```bash
# 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:

```bash
READ_ONLY_MODE=true
```

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