# Atlassian MCP Server for Heroku

A Model Context Protocol (MCP) server for Jira and Confluence integration.

[![Deploy to Heroku](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/dsouza-anush/mcp-atlassian)

## Features

- **Jira** - Search issues, create/update tickets, manage sprints and boards
- **Confluence** - Search and manage documentation pages
- **Heroku Native** - Designed for Heroku deployment with MCP process support

## Available Tools

### Jira Tools
| Tool | Description |
|------|-------------|
| `jira_search_issues` | Search using JQL |
| `jira_get_issue` | Get issue details |
| `jira_create_issue` | Create new issue |
| `jira_update_issue` | Update issue fields |
| `jira_transition_issue` | Change issue status |
| `jira_add_comment` | Add comment to issue |
| `jira_list_projects` | List all projects |
| `jira_list_boards` | List agile boards |
| `jira_list_sprints` | List sprints for a board |

### Confluence Tools
| Tool | Description |
|------|-------------|
| `confluence_list_spaces` | List all spaces |
| `confluence_get_page` | Get page content |
| `confluence_search` | Search with CQL |
| `confluence_create_page` | Create new page |
| `confluence_update_page` | Update page content |

## Deployment

### One-Click Deploy

Click the "Deploy to Heroku" button above.

### Configure Credentials

```bash
heroku config:set ATLASSIAN_DOMAIN=your-company.atlassian.net
heroku config:set ATLASSIAN_EMAIL=your-email@company.com
heroku config:set ATLASSIAN_API_TOKEN=your-api-token
```

Get your API token at https://id.atlassian.com/manage-profile/security/api-tokens

## Register with Heroku AI

```bash
heroku addons:attach your-main-app::INFERENCE -a my-atlassian-mcp
```

## Usage

```python
response = client.chat.completions.create(
    model=os.getenv("INFERENCE_MODEL_ID"),
    messages=[
        {"role": "user", "content": "Find all open bugs in project MYPROJ"}
    ],
    extra_body={
        "heroku": {
            "mcp_servers": ["mcp-atlassian"]
        }
    }
)
```

## License

MIT