appachhi/bugasura-mcp-server

Bugasura MCP Server

Connect AI assistants directly to your test management workspace.

Bugasura MCP Server enables AI tools like Claude, VS Code Copilot, and Cursor to interact with your Bugasura projects—manage test cases, track issues, plan sprints, and more—all through natural language.

Features

• 📋 Test Case Management - Create, update, delete, and search test cases
• 🐛 Issue Tracking - Report, manage, and delete bugs with rich context
• 🏃 Sprint Planning - Create, update, delete, and manage agile sprints
• 👥 Team Collaboration - Assign work using names or emails (auto-resolves to user IDs)
• 🔍 Smart Discovery - Find projects and teams without memorizing IDs
• 🤖 Interactive Workflows - Guided context selection for all operations

Quick Start

1. Get Your API Key

1. Go to Bugasura
2. Navigate to: Settings → API Key
3. Copy your API key

2. Install the MCP Server

Choose your AI tool:

{
  "servers": {
    "bugasura": {
      "type": "https",
      "url": "https://mcp.bugasura.io/sse"
    }
  }
}

claude mcp add --transport http bugasura https://mcp.bugasura.io/sse

{
  "mcpServers": {
    "bugasura": {
      "url": "https://mcp.bugasura.io/sse",
      "type": "https"
    }
  }
}

{
  "mcpServers": {
    "bugasura": {
      "serverUrl": "https://mcp.bugasura.io/sse"
    }
  }
}

{
  "mcpServers": {
    "bugasura": {
      "url": "https://mcp.bugasura.io/sse",
      "type": "streamableHttp"
    }
  }
}

{
  "mcpServers": {
    "bugasura": {
      "type": "streamable-http",
      "url": "https://mcp.bugasura.io/sse"
    }
  }
}

3. Start Using It

Once installed, just talk naturally to your AI assistant:

"List all my Bugasura teams and projects"

"Create a test case for login functionality with high severity"

"Show me all critical bugs in sprint 5"

How It Works

No IDs Required

Bugasura MCP features interactive context selection. You don't need to know team IDs, project IDs, or user IDs—just describe what you want in natural language.

Example: Creating an issue without knowing any IDs:

You: "Create a bug for the login button not working"

AI: [Calls MCP server]
    "Which team should I use?
     1. Acme Corp (Admin)
     2. Client Project (Member)"

You: "Acme Corp"

AI: "Which project?
     1. Mobile App
     2. Web App"

You: "Mobile App"

AI: "Which sprint?
     1. Sprint 5 (IN PROGRESS)
     2. Sprint 6 (SCHEDULED)"

You: "Sprint 5"

AI: ✓ "Created issue #ISSUE-123 in Sprint 5"

The system guides you through team → project → sprint selection automatically.

Smart Assignee Resolution

Assign work using names, emails, or user IDs—the system automatically converts them:

"Assign issue 123 to John Doe"

"Add jane@example.com and user 789 to issue 456"

"Remove Sarah from issue 321"

Works for both issues and test cases.

Discovery Tools

Find resources without memorizing IDs:

"Find my mobile app project"
→ Searches across ALL teams automatically

"Show me all projects I have access to"
→ Returns complete context in one call

What You Can Do

📋 Test Cases

Create an API test case for user authentication with priority P1

List all test cases for the mobile app project

Update test case 123 to mark it as PASS

Assign test case 456 to john@example.com

Delete test case 789

Delete test case with key "TES5"

Delete test case named "Verify login with valid credentials"

🐛 Issues & Bugs

Create a critical bug for login page crash in sprint 5

Show me all open issues assigned to me

Update issue 789 to change status to "Fixed"

Add John and Jane as assignees to issue 123

Delete issue 456

Delete issue with key "ISS09"

Delete issue with summary "Login button not working"

🏃 Sprints

Create a new sprint called "Sprint 15" for the mobile app

List all sprints for project 456

Update sprint 789 to mark it as COMPLETED

Show sprint details including issue statistics

Delete sprint 321

Delete sprint named "Sprint 15"

👥 Team Management

List all members of team 123

Find my team by name "Acme"

Show all projects in team 456

Available Tools

Available Resources

MCP resources provide read-only access to your Bugasura data. AI assistants can access these directly:

Advanced Usage

Pagination

List operations return 10 results by default:

Show me the first 20 issues (using max_results=20)

Show me issues 11-20 (using start_at=10, max_results=10)

Partial Updates

Update only the fields you want to change:

Update issue 123 to change severity to HIGH
(other fields remain unchanged)

Custom Fields

Create issue with custom fields: {"Environment": "Production", "Build": "1.2.3"}

Filtering

List issues for sprint 5 only

Search projects containing "mobile" in the name

Transport Modes

Bugasura MCP supports two transport modes:

STDIO (Default) - For local MCP clients

python server.py --transport stdio

SSE (Server-Sent Events) - For remote deployment

python server.py --transport sse

The hosted version at https://mcp.bugasura.io/sse uses SSE transport.

Important Notes

API Key

All operations require a Bugasura API key. Get yours from Bugasura Settings.

IMPORTANT: Do not use placeholders like $BUGASURA_API_KEY. The server detects and rejects placeholder values.

Interactive Mode

If you don't provide team_id or project_id, the system automatically enters interactive mode and guides you through selection. This works for:

• All sprint operations
• All issue operations
• All test case operations

Smart Assignees

When assigning work, you can use:

• Names: "John Doe" (partial match, case-insensitive)
• Emails: "john@example.com" (exact match, case-insensitive)
• User IDs: "123" (direct match)
• Mixed: "John, jane@example.com, 789" (comma-separated)

The system automatically resolves names/emails to user IDs.

Sprint Requirements

• Sprint names must be 5-250 characters
• Issues must be assigned to a sprint
• Updates require the issue to have a sprint assigned

Example Conversations

Getting Started

"What teams and projects do I have access to?"
→ Returns all your teams and projects

"Find my authentication project"
→ Searches across all teams and returns matches

Test Management

"Create a test case for password reset with severity HIGH and priority P1"
→ Guides you through team/project selection, then creates test case

"List all test cases in my mobile app project"
→ Returns paginated test case list

"Update test case 456 to mark it as PASS and assign to john@example.com"
→ Updates test case and resolves email to user ID

Bug Tracking

"Show me all critical bugs in sprint 5"
→ Lists critical severity issues filtered by sprint

"Create a bug: Login button crashes on iOS 17"
→ Guides through team/project/sprint selection, creates issue

"Assign issue 789 to Jane and mark it as In Progress"
→ Updates assignee and status

Sprint Planning

"Create a 2-week sprint called 'Sprint 16' starting next Monday"
→ Guides through project selection, creates sprint with dates

"Show me sprint statistics for sprint 5"
→ Returns issue counts, completion rates, etc.

"Mark sprint 12 as COMPLETED"
→ Updates sprint status

Support

• 🌐 Website
• 📧 Contact support for assistance
• 📚 API Documentation

License

MIT