# Issue Tracker MCP

Stop context switching between code and Jira.

![MCPize](https://img.shields.io/badge/MCPize-live-brightgreen) ![License: MIT](https://img.shields.io/badge/License-MIT-blue)

## Quick Start

Add to your MCP client config:

```json
{
  "mcpServers": {
    "issue-tracker": {
      "url": "https://your-cloud-run-url/mcp"
    }
  }
}
```

## Before / After

**Before:** Open browser, navigate to Jira, find the project, click New Issue, fill in fields, copy the ticket ID back into your terminal.

**After:**

Input:
```json
{
  "title": "Auth token expires too early on mobile",
  "type": "bug",
  "priority": "high",
  "project": "WEBAPP",
  "assignee": "alice"
}
```

Output:
```json
{
  "message": "Issue created: ISS-1",
  "issue": {
    "id": "ISS-1",
    "title": "Auth token expires too early on mobile",
    "status": "todo",
    "priority": "high",
    "type": "bug",
    "project": "WEBAPP",
    "assignee": "alice",
    "createdAt": "2026-04-03T12:00:00.000Z"
  }
}
```

## Tools

| Tool | What it does |
|------|--------------|
| `create_issue` | Create a new issue with title, type, priority, and project |
| `list_issues` | List and filter issues by status, priority, assignee, or sprint |
| `get_issue` | Fetch full details for a single issue including all comments |
| `update_issue` | Change status, assignee, priority, or any other field |
| `delete_issue` | Permanently remove a duplicate or mistaken issue |
| `add_comment` | Append a comment to an issue with author and timestamp |
| `create_sprint` | Create a sprint with name, goal, start date, and end date |
| `list_sprints` | List sprints filtered by project or status |
| `add_to_sprint` | Move one or more issues into a sprint for planning |
| `search_issues` | Full-text search across issue titles and descriptions |
| `get_sprint_board` | Kanban view of a sprint with issues grouped by status column |
| `get_project_stats` | Project health report: counts by status, priority, and type |

## Who is this for?

- Developers who want to log bugs and feature requests without leaving the terminal
- Engineering leads who need standup summaries and sprint boards on demand
- Teams who want lightweight issue tracking without paying for a SaaS subscription

## Health Check

```
GET /
GET /health

Response: { "status": "ok", "server": "issue-tracker", "version": "1.0.0", "tools": 12 }
```

## Built by

Built by [Mastermind HQ](https://mastermindshq.business)

## License

MIT