id       = "mcp-atlassian"
name     = "MCP Atlassian"
homepage = "https://github.com/sooperset/mcp-atlassian"
description = "MCP server for Atlassian Jira and Confluence."
executables   = ["mcp-atlassian"]

[dotfiles]

# The official .env.example documents the OAuth fallback as a local file in
# ~/.mcp-atlassian/ (the primary alternative is the OS keyring). The filename
# is deliberately unspecified upstream, so the directory is protected as a
# whole rather than guessing a file name.
# https://github.com/sooperset/mcp-atlassian/blob/main/.env.example
paths = []
secret = ["~/.mcp-atlassian/"]

[commands]
format = 1
label = "Run MCP Atlassian server"
description = "Start the server with a transport, port, tool filter and logging level. Credentials come from environment variables or an env file; toolsets and other options are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = false, short_attached = false, short_bundles = false }

[[commands.source]]
id = "docs"
kind = "manual"
url = "https://mcp-atlassian.soomiles.com/llms-full.txt"
revision = "2026-10-27"
evidence = """
uvx mcp-atlassian --oauth-setup -v
uvx mcp-atlassian --transport streamable-http --stateless --port 9000 -vv
--env-file /path/to/your/.env \\
uvx mcp-atlassian --transport sse --port 9000 -vv
uvx mcp-atlassian --enabled-tools "confluence_search,jira_get_issue"
| `TRANSPORT` | Transport type (`stdio`, `sse`, `streamable-http`) |
| `PORT` | Port for HTTP transports (default: `8000`) |
"""

[[commands.field]]
id = "transport"
label = "Transport"
type = "enum"
option = ["--transport"]
choices = [{ value = "stdio", label = "stdio" }, { value = "sse", label = "SSE" }, { value = "streamable-http", label = "Streamable HTTP" }]
sources = ["docs"]

[[commands.field]]
id = "port"
label = "Port"
description = "For the HTTP transports; default 8000."
type = "integer"
option = ["--port"]
sources = ["docs"]

[[commands.field]]
id = "stateless"
label = "Stateless mode"
description = "For streamable-http, e.g. Kubernetes deployments."
type = "boolean"
option = ["--stateless"]
sources = ["docs"]

[[commands.field]]
id = "enabled_tools"
label = "Enabled tools"
description = "Comma-separated tool names, e.g. confluence_search,jira_get_issue."
type = "string"
option = ["--enabled-tools"]
sources = ["docs"]

[[commands.field]]
id = "env_file"
label = "Env file"
type = "path"
option = ["--env-file"]
path = { kind = "file", role = "input" }
sources = ["docs"]

[[commands.field]]
id = "oauth_setup"
label = "OAuth setup wizard"
type = "boolean"
option = ["--oauth-setup"]
sources = ["docs"]

[[commands.field]]
id = "verbose"
label = "Verbosity"
description = "-v for verbose, repeat for debug logging."
type = "count"
option = ["-v"]
sources = ["docs"]

[[commands.task]]
id = "http"
label = "Serve over HTTP"
fields = ["transport", "port", "stateless", "verbose"]
required = ["transport", "port"]
set = { transport = ["streamable-http"] }

[[commands.task]]
id = "oauth"
label = "Run OAuth setup"
fields = ["oauth_setup", "verbose"]
required = ["oauth_setup"]
set = { oauth_setup = [true] }

[[commands.group]]
id = "basic"
label = "Basic"
fields = ["transport", "port", "enabled_tools", "verbose"]

[[commands.group]]
id = "advanced"
label = "Advanced"
fields = ["stateless", "env_file", "oauth_setup"]