# ahmetbarut/jira-mcp architecture

> Architecture diagram of the GitHub repository ahmetbarut/jira-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ahmetbarut/jira-mcp
- Repository: https://github.com/ahmetbarut/jira-mcp

## Overview

This is a stdio-based MCP server that exposes Jira Cloud operations to MCP clients. The main workflow is client tool invocation → MCP dispatch and credential loading → a domain handler → Jira API access → formatted MCP content returned to the client. Handlers cover board listing, board-scoped current-user issues, issue details and comments, user lookup, and user/server information. The sampled source confirms direct HTTP for comments and a shared authenticated API helper for other requests; unsampled implementation details are not inferred.

Main entry points: [`src/index.ts`](https://github.com/ahmetbarut/jira-mcp/blob/main/src/index.ts) (MCP server), [`src/jiraApi.ts`](https://github.com/ahmetbarut/jira-mcp/blob/main/src/jiraApi.ts) (Jira API helper), [`src/handlers.ts`](https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts) (List boards), [`src/tools.ts`](https://github.com/ahmetbarut/jira-mcp/blob/main/src/tools.ts) (Tool definitions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mcp["MCP interface"]
  node_server["MCP server<br/>[index.ts]"]
  node_tooldefs["Tool definitions<br/>[tools.ts]"]
end

subgraph group_domain["Jira operations"]
  node_boards["List boards<br/>[handlers.ts]"]
  node_issues["Board issues<br/>[handlers.ts]"]
  node_issue_detail["Issue details<br/>[handlers.ts]"]
  node_comments["Add comment<br/>[handlers.ts]"]
  node_user_info["User information<br/>[handlers.ts]"]
  node_user_search["Search users<br/>[handlers.ts]"]
  node_server_info["Server information<br/>[handlers.ts]"]
end

subgraph group_integration["Jira integration"]
  node_config["Credential config<br/>[jiraApi.ts]"]
  node_api["Jira API helper<br/>[jiraApi.ts]"]
end

node_client(("MCP client"))
node_jira["Jira Cloud"]

node_client -->|"calls tools"| node_server
node_server -->|"lists tools"| node_tooldefs
node_server -->|"loads credentials"| node_config
node_server -->|"dispatches"| node_boards
node_server -->|"dispatches"| node_issues
node_server -->|"dispatches"| node_issue_detail
node_server -->|"dispatches"| node_comments
node_server -->|"dispatches"| node_user_info
node_server -->|"dispatches"| node_user_search
node_server -->|"dispatches"| node_server_info
node_boards -->|"requests boards"| node_api
node_issues -->|"requests board and issues"| node_api
node_issue_detail -->|"requests issue"| node_api
node_user_info -->|"requests user and server"| node_api
node_user_search -->|"searches users"| node_api
node_server_info -->|"requests server info"| node_api
node_comments -->|"posts comment"| node_jira
node_api -->|"sends API requests"| node_jira
node_server -->|"returns tool result"| node_client

click node_server "https://github.com/ahmetbarut/jira-mcp/blob/main/src/index.ts"
click node_tooldefs "https://github.com/ahmetbarut/jira-mcp/blob/main/src/tools.ts"
click node_config "https://github.com/ahmetbarut/jira-mcp/blob/main/src/jiraApi.ts"
click node_boards "https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts"
click node_issues "https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts"
click node_issue_detail "https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts"
click node_comments "https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts"
click node_user_info "https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts"
click node_user_search "https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts"
click node_server_info "https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts"
click node_api "https://github.com/ahmetbarut/jira-mcp/blob/main/src/jiraApi.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_tooldefs,node_client toneBlue
class node_boards,node_issues,node_issue_detail,node_comments,node_user_info,node_user_search,node_server_info toneAmber
class node_config,node_api toneMint
class node_jira toneIndigo
```

## Components

### MCP interface

- [MCP server](https://github.com/ahmetbarut/jira-mcp/blob/main/src/index.ts): `src/index.ts`
- [Tool definitions](https://github.com/ahmetbarut/jira-mcp/blob/main/src/tools.ts): `src/tools.ts`

### Jira operations

- [List boards](https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts): `src/handlers.ts`
- [Board issues](https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts): `src/handlers.ts`
- [Issue details](https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts): `src/handlers.ts`
- [Add comment](https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts): `src/handlers.ts`
- [User information](https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts): `src/handlers.ts`
- [Search users](https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts): `src/handlers.ts`
- [Server information](https://github.com/ahmetbarut/jira-mcp/blob/main/src/handlers.ts): `src/handlers.ts`

### Jira integration

- [Credential config](https://github.com/ahmetbarut/jira-mcp/blob/main/src/jiraApi.ts): `src/jiraApi.ts`
- [Jira API helper](https://github.com/ahmetbarut/jira-mcp/blob/main/src/jiraApi.ts): `src/jiraApi.ts`

### Other components

- **MCP client**
- **Jira Cloud**

## Connections

- MCP client → MCP server: calls tools
- MCP server → Tool definitions: lists tools
- MCP server → Credential config: loads credentials
- MCP server → List boards: dispatches
- MCP server → Board issues: dispatches
- MCP server → Issue details: dispatches
- MCP server → Add comment: dispatches
- MCP server → User information: dispatches
- MCP server → Search users: dispatches
- MCP server → Server information: dispatches
- List boards → Jira API helper: requests boards
- Board issues → Jira API helper: requests board and issues
- Issue details → Jira API helper: requests issue
- User information → Jira API helper: requests user and server
- Search users → Jira API helper: searches users
- Server information → Jira API helper: requests server info
- Add comment → Jira Cloud: posts comment
- Jira API helper → Jira Cloud: sends API requests
- MCP server → MCP client: returns tool result