ajaia-mcp-server

AI Jira & Azure DevOps MCP Server

Model Context Protocol (MCP) server that lets Claude, Cursor, and other MCP-compatible tools manage Jira and Azure DevOps work items using natural language.

Turn your AI assistant into a Jira and Azure DevOps copilot directly inside your editor.

Overview

ajaia-mcp-server exposes Jira and Azure DevOps as structured MCP tools so AI assistants can search, filter, create, and modify work items, comments, and basic reports in response to natural language prompts.

Problem: Context switching between Jira, Azure DevOps, and your editor slows teams down. Engineers and PMs need a fast way to query and update work items while staying in flow.

Solution: This MCP server bridges the gap, allowing you to manage work items without leaving your editor or AI assistant.

Features

• 🔍 Search - Natural-language search over Jira and Azure DevOps work items, including project, assignee, and status filters. Find work items using natural language or JQL/WIQL queries.
• 📝 Create - Create and update issues, bugs, tasks, and stories with titles, descriptions, and fields generated by AI.
• ✏️ Update - Modify status, assignee, priority, and more. Update existing work items with natural language commands.
• 💬 Comment - Add comments and quick updates directly from Claude, Cursor, or other MCP clients.
• 📊 Reports - Generate lightweight sprint and status summaries by pulling data from Jira and Azure DevOps.
• 🤖 AI Chat - Ask questions about your projects, work items, and get help with project management.
• 🔗 Dual Platform - Works seamlessly with both Jira and Azure DevOps from a single interface.

Primary Use Cases

1. Find, Summarize, and Triage Work Items

Ask AI to find, summarize, and triage Jira and Azure DevOps work items:

"Show me all active bugs assigned to me and summarize them"
"Find high-priority issues in project ABC and group them by assignee"
"What work items are blocking the current sprint?"

2. Create and Update Work Items from Natural Language

Create and update issues, bugs, tasks, and user stories from natural language prompts:

"Create a bug in project ABC titled 'Login button not working' with description 'The login button does not respond when clicked'"
"Update issue PROJ-123 to set status to 'In Progress' and assign to [email protected]"
"Create a user story for implementing user authentication"

3. Generate Sprint and Status Reports

Generate sprint and status reports across Jira projects and Azure DevOps boards:

"Generate a sprint summary for project MyApp"
"Create a status report for all active epics in Azure DevOps"
"What's the velocity trend for the last 3 sprints?"

Installation

Quick Start (NPX - Recommended)

The simplest way to use ajaia-mcp-server is via NPX:

npx ajaia-mcp-server

Global Installation

Or install globally for easier access:

npm install -g ajaia-mcp-server

Local Installation

For development or custom configurations:

npm install ajaia-mcp-server

Configuration

Getting Your API Key

1. Sign up at AJAIA
2. Connect your Jira and/or Azure DevOps accounts
3. Go to Settings → MCP API Keys
4. Click Generate New Key
5. Copy the key and add it to your MCP configuration

Claude Desktop

Add to your claude_desktop_config.json (location varies by OS):

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ajaia": {
      "command": "npx",
      "args": ["-y", "ajaia-mcp-server"],
      "env": {
        "AJAIA_API_KEY": "your-api-key-here",
        "AJAIA_API_URL": "https://ajaia.subscriptionsense.com"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings (~/.cursor/mcp.json or via Settings > MCP):

{
  "mcpServers": {
    "ajaia": {
      "command": "npx",
      "args": ["-y", "ajaia-mcp-server"],
      "env": {
        "AJAIA_API_KEY": "your-api-key-here",
        "AJAIA_API_URL": "https://ajaia.subscriptionsense.com"
      }
    }
  }
}

VS Code

If using a VS Code MCP extension, add similar configuration to your VS Code settings.

Available Tools

| Tool | Description | | ------------------- | --------------------------------------------------------------------------- | | get_my_work_items | Get work items assigned to the current user, with optional status filtering | | search_work_items | Search using natural language or JQL/WIQL queries across projects | | analyze_work_item | AI-powered analysis with insights, suggestions, and risk assessment | | create_work_item | Create issues, bugs, stories, tasks with AI-generated descriptions | | update_work_item | Update status, assignee, priority, and other fields on existing work items | | add_comment | Add comments to work items directly from your AI assistant | | generate_report | Generate sprint summaries, velocity reports, burndown charts, and status reports | | ai_chat | Have conversations about your projects, work items, and get AI assistance |

Example Prompts

Once configured, you can ask your AI assistant natural language questions:

Search and Discovery

"Ask Jira assistant in Claude to find all active bugs assigned to you and summarize them"
"Search for high priority issues in Azure DevOps project MyApp"
"Show me all user stories in the current sprint"

Creation and Updates

"Tell Cursor to create a new Azure DevOps user story from an acceptance-criteria block in your code review"
"Create a bug titled 'API timeout error' in project ABC"
"Update issue PROJ-123 to set priority to High and assign to the backend team"

Reports and Analysis

"Request a sprint summary across Jira and Azure DevOps boards for your team"
"Generate a status report for all epics in the current quarter"
"Analyze issue PROJ-123 and suggest improvements"
"What's blocking the current sprint?"

AI Chat

"What are the most critical bugs in my project?"
"Help me prioritize my backlog items"
"Explain the dependencies between these work items"

Environment Variables

| Variable | Required | Description | Default | | --------------- | -------- | ------------------------------------------------ | ------------------------------------ | | AJAIA_API_KEY | Yes | Your AJAIA API key (get from Settings → MCP API Keys) | - | | AJAIA_API_URL | No | Custom API URL | https://ajaia.subscriptionsense.com |

Requirements

• Node.js: 18.0.0 or higher
• AJAIA Account: Sign up at ajaia.subscriptionsense.com
• Connected Accounts: At least one Jira or Azure DevOps account connected in AJAIA

Simple NPX-based Installation

The package is designed for simple NPX-based installation and environment configuration:

# No installation needed - just use NPX
npx ajaia-mcp-server

The server will automatically:

• Connect to your AJAIA account using the provided API key
• Access your connected Jira and/or Azure DevOps accounts
• Provide all tools to your MCP-compatible AI assistant

Support

• 📧 Email: [email protected]
• 🌐 Website: https://ajaia.subscriptionsense.com
• 🐛 Issues: https://github.com/pokiDaddy/Ultimate-Jira-ADO-MCP-AI-Assistant-Chatbot/issues
• 📖 Documentation: https://github.com/pokiDaddy/Ultimate-Jira-ADO-MCP-AI-Assistant-Chatbot#readme

License

MIT

Keywords

MCP, Model Context Protocol, Jira, Azure DevOps, DevOps, AI Assistant, Claude, Cursor, Work Item Management, Project Management, Agile, Scrum, Backlog Management, Sprint Reports, Natural Language Processing