# @mcpengine/jira

Complete MCP server for Jira/Atlassian integration.

## Features

- 60+ tools covering issues, projects, boards, sprints, users, comments, attachments, transitions, fields, filters, dashboards, and webhooks
- 18 React-based UI apps for visual interaction
- Full TypeScript support with strict type checking
- Rate limiting and pagination handling
- Support for both Basic Auth (email+API token) and OAuth2 Bearer tokens

## Setup

1. Copy `.env.example` to `.env` and fill in your credentials:
   ```bash
   cp .env.example .env
   ```

2. Install dependencies:
   ```bash
   npm install
   ```

3. Build:
   ```bash
   npm run build
   ```

4. Run:
   ```bash
   npm start
   ```

## Development

```bash
npm run dev
```

## Authentication

### Basic Auth (Recommended)
Set `JIRA_DOMAIN`, `JIRA_EMAIL`, and `JIRA_API_TOKEN` in your `.env` file.

### OAuth2 Bearer Token
Set `JIRA_DOMAIN` and `JIRA_BEARER_TOKEN` in your `.env` file.

## Available Tools

See `src/tools/` for the complete list of 60+ tools organized by category.

## Apps

18 React-based UI apps available in `src/apps/`:
- issue-tracker, project-dashboard, board-view, sprint-planner
- backlog-manager, kanban-board, user-directory, comment-feed
- attachment-manager, workflow-editor, field-configurator, filter-builder
- dashboard-viewer, jql-console, roadmap-view, velocity-chart
- burndown-chart, release-manager