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
• 💬 Test Case Comments - Add, update, delete, and list comments on test cases with pagination and filtering
• 🐛 Issue Tracking - Report, manage, and delete bugs with rich context
• 💬 Issue Comments - Add, update, delete, and list comments on issues with pagination and filtering
• 📝 Requirements Management - Create, organize, and manage product requirements with folder structure
• 🏃 Sprint Planning - Create, update, delete, and manage agile sprints
• 👥 Team Collaboration - Assign work using names or emails (auto-resolves to user IDs)
• 👤 Team Member Management - Add, update roles, and remove team members using team names or 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"

"Create a requirement for user authentication feature"

"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"

💬 Test Case Comments

List all comments on test case 123

List comments on test case "Verify login with valid credentials"

List only user comments on test case 456 (exclude system comments)

Get details of comment 789

Add a comment "Test passed on Chrome and Firefox" to test case 123

Add a private comment to test case 456

Update comment 789 with new text

Delete comment 456

📝 Requirements

Create a requirement titled "User Authentication" with details and priority P1

List all requirements for the mobile app project

Get requirement details for requirement ID 2036

Update requirement 2036 to change severity to HIGH

Assign requirement 456 to john@example.com

Create a folder named "Sprint 1 Features" for organizing requirements

List all requirement folders in a project

Delete requirement 789

Link test cases to requirement 2036

🐛 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"

💬 Issue Comments

List all comments on issue 123

List comments with pagination (start at 10, show 20 results)

List only user comments, exclude system comments

Get details of comment 456

Add a comment "Fixed in latest build" to issue 789

Add a private comment to issue 123

Update comment 456 with new text

Delete comment 789

🏃 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"

📋 Projects

List all projects in team 123

Find project by name "Mobile App"

Get detailed information for project 456

Create a new project "E-commerce Web App" in team 123

Update project 789 name to "Mobile Application"

Update project "Mobile App" to change issue prefix to "MOB"

Delete project 321

Delete project "Old Test Project"

👥 Team Management

List all my teams

Find team by name "Acme"

Get detailed information for team 123

Get detailed information for team "Engineering"

Create a new team called "Mobile App Team"

Update team 456 name to "Web Development Team"

Rename team "Mobile Team" to "Mobile App Development"

List all members in team "Acme Corp"

Add john@example.com and jane@example.com to team "Engineering"

Invite user@example.com to team 123

Promote user 456 to admin in team "Marketing"

Demote user to regular member in team "Sales"

Remove john@example.com from team "Sales"

Remove user by name "John Doe" from team 123

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)

Show me the first 50 comments on issue 123 (using max_results=50)

Show me comments 21-40 on issue 456 (using start_at=20, max_results=20)

Partial Updates

Update only the fields you want to change - all other fields are automatically preserved:

Update issue 123 to change severity to HIGH
(other fields like status, description, assignees remain unchanged)

Update requirement 2036 to change title only
(severity, priority, assignees, and all other fields are preserved)

How It Works: All update operations (issues, requirements, test cases, sprints) fetch the existing record first, then merge your changes with existing data before sending to the API. This ensures no fields are accidentally cleared or reset.

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

List only user comments on issue 123 (exclude system-generated comments)

List comments by a specific user on issue 456 (using creator_id filter)

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.

Testing & Debugging with MCP Inspector

The MCP Inspector provides a web-based interface to test and debug your MCP server.

Quick Start

1. Install MCP Inspector (if not already installed):

   npm install -g @modelcontextprotocol/inspector
   

2. Run the Inspector:

   cd /Applications/MAMP/htdocs/api.appachhi.com/Bugasura-MCP
   source .venv/bin/activate
   npx @modelcontextprotocol/inspector python server.py
   

3. Open your browser - The inspector will automatically open at http://localhost:5173

What You Can Do

• ✅ View all tools with their parameters and documentation
• ✅ Test tools interactively - Call any tool and see real responses
• ✅ Debug workflows - Test create → update → delete flows
• ✅ Validate parameters - Ensure correct formats and types
• ✅ Test name-based operations - Try deleting by issue key (ISS09), test case key (TES5), or names
• ✅ Test team resolution - Use team names instead of IDs for team member management

Example Tests

Test Issue Deletion by Key:

Tool: delete_issue
Parameters: {
  "api_key": "your_api_key",
  "issue_identifier": "ISS09"
}

Test Interactive Sprint Selection:

Tool: create_issue
Parameters: {
  "api_key": "your_api_key",
  "summary": "Test issue"
}
// Returns selection prompt for team → project → sprint

Test Team Member Management with Team Name:

Tool: add_team_members
Parameters: {
  "api_key": "your_api_key",
  "team_name": "Engineering",
  "email_list": "john@example.com, jane@example.com"
}
// Resolves team name and sends invitations

Test User Removal with Smart Resolution:

Tool: delete_team_user
Parameters: {
  "api_key": "your_api_key",
  "team_id": 123,
  "user_identifier": "john@example.com"
}
// Resolves user by email and removes from team

For detailed instructions, see

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.

Smart Team Resolution

Team member management tools support flexible team identification:

• Team IDs: team_id=123 (direct numeric ID)
• Team Names: team_name="Acme Corp" (partial match, case-insensitive)

You can use either parameter for:

• add_team_members - Invite users to a team
• update_team_member - Change member roles
• delete_team_user - Remove team members

Examples:

add_team_members(api_key, team_name="Engineering", email_list="john@example.com")
update_team_member(api_key, team_id=123, user_id=456, is_admin=1)
delete_team_user(api_key, team_name="Sales", user_identifier="john@example.com")

Data Requirements

Sprints:

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

Requirements:

• Requirements must be organized in folders
• Folder ID is required for all requirement operations
• Requirements can have parent-child hierarchy (max 2 levels: parent cannot have another parent)

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

Issue Comments

"List all comments on issue 123"
→ Returns all comments with user details and timestamps

"Show me the next 10 comments starting from comment 11"
→ Uses pagination (start_at=10, max_results=10)

"List only user comments, exclude system-generated ones"
→ Uses get_user_comments_only=True to filter out system comments

"Add a comment 'Fixed in version 2.1.0' to issue 456"
→ Guides through team/project/issue selection, creates public comment

"Add a private comment about internal notes to issue 789"
→ Creates comment with is_public_comment=0

"Update comment 321 to fix a typo"
→ Guides through interactive selection if comment details not provided

"Delete comment 456"
→ Shows deletion warning, removes comment permanently

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

Requirements Management

"Create a requirement titled 'User Authentication' with details 'Implement OAuth 2.0' and priority P1"
→ Guides through team/project selection, prompts for folder selection, creates requirement

"List all requirements in my mobile app project"
→ Returns all requirements with their hierarchy and test case counts

"Link test cases 123 and 456 to requirement 2036"
→ Creates traceability between requirements and test cases

"Update requirement 2036 to change severity to HIGH and assign to john@example.com"
→ Updates requirement fields while preserving all other data

Team Member Management

"Add john@example.com and jane@example.com to the Engineering team"
→ Resolves team by name, sends email invitations to new members

"List all members of team Acme Corp"
→ Returns team members with names, emails, user IDs, and roles

"Promote user 456 to admin in the Marketing team"
→ Updates team member role from member to admin

"Remove john@example.com from the Sales team"
→ Resolves user by email, removes from team and unassigns all their issues

"Make Sarah an admin in team 123"
→ Resolves user by name, promotes to admin role

Support

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

License

MIT