atlassian-agent 0.8.0

Comprehensive AI agent for Jira and Confluence management.

Atlassian Agent - A2A | AG-UI | MCP

Version: 0.8.0

Overview

Atlassian Agent MCP Server + A2A Agent

Comprehensive AI agent for Jira and Confluence management.

This repository is actively maintained - Contributions are welcome!

MCP

Using as an MCP Server

The MCP Server can be run in two modes: stdio (for local testing) or http (for networked access).

Environment Variables

Shared Cloud Variables:

• ATLASSIAN_AGENT_URL: The URL of the target service (e.g. https://your-company.atlassian.net).
• ATLASSIAN_AGENT_TOKEN: The API token or access token for Cloud.

Jira Server Variables:

• ATLASSIAN_JIRA_SERVER_URL: The URL of the Jira Server.
• ATLASSIAN_JIRA_SERVER_USER: The username for Jira Server.
• ATLASSIAN_JIRA_SERVER_TOKEN: The token/password for Jira Server.
• ATLASSIAN_JIRA_SERVER_VERIFY: Boolean to verify SSL for Jira Server.

Confluence Server Variables:

• ATLASSIAN_CONFLUENCE_SERVER_URL: The URL of the Confluence Server.
• ATLASSIAN_CONFLUENCE_SERVER_USER: The username for Confluence Server.
• ATLASSIAN_CONFLUENCE_SERVER_TOKEN: The token/password for Confluence Server.
• ATLASSIAN_CONFLUENCE_SERVER_VERIFY: Boolean to verify SSL for Confluence Server.

Run in stdio mode (default):

export ATLASSIAN_AGENT_URL="http://localhost:8080"
export ATLASSIAN_AGENT_TOKEN="your_token"
atlassian-mcp --transport "stdio"

Run in HTTP mode:

export ATLASSIAN_AGENT_URL="http://localhost:8080"
export ATLASSIAN_AGENT_TOKEN="your_token"
atlassian-mcp --transport "http" --host "0.0.0.0" --port "8000"

A2A Agent

Run A2A Server

export ATLASSIAN_AGENT_URL="http://localhost:8080"
export ATLASSIAN_AGENT_TOKEN="your_token"
atlassian-agent --provider openai --model-id gpt-4o --api-key sk-...

Docker

Build

docker build -t atlassian-agent .

Run MCP Server

docker run -d \
  --name atlassian-agent \
  -p 8000:8000 \
  -e TRANSPORT=http \
  -e ATLASSIAN_AGENT_URL="http://your-service:8080" \
  -e ATLASSIAN_AGENT_TOKEN="your_token" \
  knucklessg1/atlassian-agent:latest

Deploy with Docker Compose

services:
  atlassian-agent:
    image: knucklessg1/atlassian-agent:latest
    environment:
      - HOST=0.0.0.0
      - PORT=8000
      - TRANSPORT=http
      - ATLASSIAN_AGENT_URL=http://your-service:8080
      - ATLASSIAN_AGENT_TOKEN=your_token
    ports:
      - 8000:8000

Configure mcp.json for AI Integration (e.g. Claude Desktop)

{
  "mcpServers": {
    "atlassian": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "atlassian-agent",
        "atlassian-mcp"
      ],
      "env": {
        "ATLASSIAN_AGENT_URL": "http://your-service:8080",
        "ATLASSIAN_AGENT_TOKEN": "your_token",
        "ATLASSIAN_JIRA_SERVER_URL": "http://your-jira-server",
        "ATLASSIAN_JIRA_SERVER_USER": "your-username",
        "ATLASSIAN_JIRA_SERVER_TOKEN": "your-jira-token",
        "ATLASSIAN_JIRA_SERVER_VERIFY": "true",
        "ATLASSIAN_CONFLUENCE_SERVER_URL": "http://your-confluence-server",
        "ATLASSIAN_CONFLUENCE_SERVER_USER": "your-username",
        "ATLASSIAN_CONFLUENCE_SERVER_TOKEN": "your-confluence-token",
        "ATLASSIAN_CONFLUENCE_SERVER_VERIFY": "true"
      }
    }
  }
}

Install Python Package

python -m pip install atlassian-agent

uv pip install atlassian-agent

Repository Owners

MCP Configuration Examples

1. Standard IO (stdio) Deployment

{
  "mcpServers": {
    "atlassian-agent": {
      "command": "uv",
      "args": [
        "run",
        "atlassian-mcp"
      ],
      "env": {
        "AGENT_DESCRIPTION": "<YOUR_AGENT_DESCRIPTION>",
        "AGENT_SYSTEM_PROMPT": "<YOUR_AGENT_SYSTEM_PROMPT>",
        "ATLASSIAN_AGENT_TOKEN": "<YOUR_ATLASSIAN_AGENT_TOKEN>",
        "ATLASSIAN_AGENT_URL": "<YOUR_ATLASSIAN_AGENT_URL>",
        "ATLASSIAN_AGENT_USER": "<YOUR_ATLASSIAN_AGENT_USER>",
        "ATLASSIAN_AGENT_VERIFY": "<YOUR_ATLASSIAN_AGENT_VERIFY>",
        "DEFAULT_AGENT_NAME": "<YOUR_DEFAULT_AGENT_NAME>"
      }
    }
  }
}

2. Streamable HTTP (SSE) Deployment

{
  "mcpServers": {
    "atlassian-agent": {
      "command": "uv",
      "args": [
        "run",
        "atlassian-mcp",
        "--transport",
        "http",
        "--host",
        "0.0.0.0",
        "--port",
        "8000"
      ],
      "env": {
        "AGENT_DESCRIPTION": "<YOUR_AGENT_DESCRIPTION>",
        "AGENT_SYSTEM_PROMPT": "<YOUR_AGENT_SYSTEM_PROMPT>",
        "ATLASSIAN_AGENT_TOKEN": "<YOUR_ATLASSIAN_AGENT_TOKEN>",
        "ATLASSIAN_AGENT_URL": "<YOUR_ATLASSIAN_AGENT_URL>",
        "ATLASSIAN_AGENT_USER": "<YOUR_ATLASSIAN_AGENT_USER>",
        "ATLASSIAN_AGENT_VERIFY": "<YOUR_ATLASSIAN_AGENT_VERIFY>",
        "DEFAULT_AGENT_NAME": "<YOUR_DEFAULT_AGENT_NAME>"
      }
    }
  }
}