# BugHerd MCP for AI Agents MCP > BugHerd connects your AI client directly to visual feedback and bug tracking workflows. Stop toggling between portals; use natural conversation to manage projects, triage new reports from clients, and update task priorities instantly. It lets you list all active development projects, retrieve detailed metadata, process incoming feedback queue items, and coordinate user involvement without ever logging into the BugHerd site. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** visual-feedback, bug-tracking, qa-testing, website-feedback, issue-management, collaboration ## Description BugHerd brings your entire visual feedback loop—from initial client report to final bug fix—into conversation with your AI agent. Instead of navigating through multiple tabs or copy-pasting links between a spreadsheet and a web portal, you talk to your AI client and it handles the rest. You can ask it to list all your current projects, get details on specific tasks, or even access the dedicated feedback queue to triage new reports from clients or team members. It's about keeping your QA process inside your natural workflow. Whether you’re working in a developer environment or writing documentation for product managers, your AI agent can pull core organizational settings and user directories right into your chat window. This integration becomes available through the Vinkius catalog, giving any MCP-compatible client immediate access to all these bug tracking tools. You control the flow of feedback using natural language, making it dramatically faster to update task statuses or create new reports without leaving your current screen. ## Tools ### create_project Builds a new project container within BugHerd for tracking related issues. ### create_task Generates a new task or feedback item in an existing project, ready for review. ### get_organization_info Fetches the core settings and details about your organization's account setup. ### get_project Retrieves all necessary information for a specific, existing project ID. ### get_task Grabs the full details and current status of any single task or bug report. ### list_feedback Pulls a list of all new, unassigned items directly from the client feedback queue. ### list_projects Generates a complete list of every project currently active in your BugHerd account. ### list_tasks Displays all tasks and bugs associated with a single, specified project. ### list_users Provides a directory listing of every user account tied to the organization. ### update_task Changes the status (e.g., To Do, Doing, Done) or updates the priority level on any existing task. ## Prompt Examples **Prompt:** ``` What's the status of the new payment gateway module? ``` **Response:** ``` **Project: Payment Gateway Integration** * **Status:** Doing (Requires final QA sign-off) * **Assigned To:** Jane Doe * **Last Update:** 2 hours ago (Updated by system) * **Priority:** High Need to check the feedback queue for any blocker issues? I found 7 new items, including a reported failure on Chrome v120. ``` **Prompt:** ``` I need to create a bug report for the mobile header alignment issue. ``` **Response:** ``` **New Task Created Successfully** * **Project:** Vinkius Redesign (ID: proj_1) * **Task Title:** Header misalignment on iPhone 14 Pro Max * **Description:** The corner element overlaps the navigation bar when viewed in landscape mode. * **Status:** To Do * **Priority:** High A new task has been logged and assigned to the development team. ``` **Prompt:** ``` Can you list all my projects and tell me who is on them? ``` **Response:** ``` **Active Projects Overview** | Project Name | ID | Status | | :--- | :--- | :--- | | Vinkius Redesign | proj_1 | Active | | Client Portal | proj_2 | Paused | | Marketing Blog | proj_3 | Complete | Users available across all projects include John Smith (role: PM), Jane Doe (role: QA), and Michael Chen (role: Dev). ``` ## Capabilities ### Identify and manage projects List all active development projects and retrieve detailed metadata for each one. ### Manage tasks and bugs Get details on a specific task, list all tasks within a project, or update the status and priority of existing issues. ### Triage client feedback queue Access and review new visual reports from your clients and team in the dedicated feedback queue. ### Create project components Start a brand new project or create a new task/feedback report directly within your workflow. ### Coordinate organization details Access the organization's core settings and retrieve a directory of all organization users. ## Use Cases ### Responding to a client's screenshot A designer gets a high-res screenshot of a mobile layout issue. Instead of emailing it and waiting for someone to manually input it, they ask their agent: 'Can you create a new task in the Client Portal project with this description?' The agent uses create_task instantly. ### Updating status across multiple teams The QA tester finishes testing a module and needs to move three separate bugs. They ask: 'Update tasks A, B, and C in the Vinkius Redesign project to 'Done' and set priority to Low.' The agent uses update_task for all three. ### Getting an overview of development scope The Project Manager needs a quick list of every active site. They ask their agent: 'List all my BugHerd projects and give me the main URL for each.' The agent uses list_projects, providing immediate project oversight. ### Onboarding a new team member The manager needs to know who is on the current development roster. They ask: 'List all users in the organization.' The agent uses list_users and provides an immediate directory, speeding up coordination. ## Benefits - Instantly check project status or retrieve feedback details using the get_task and list_tasks tools, eliminating manual logins to your bug tracking portal. - Triage incoming client reports directly by calling list_feedback. You can review new items without ever leaving your primary workflow tool. - Maintain a clear record of all work streams by listing projects or creating brand new ones using create_project and get_project. - Keep project oversight tight: you can retrieve core organization settings via get_organization_info, keeping everyone on the same page about scope and rules. - Streamline communication by accessing user details through list_users, ensuring that every assigned bug has the right person involved. ## How It Works The bottom line is that you talk to your agent like talking to a coworker; it handles the complex API calls to BugHerd in the background. 1. Subscribe to this MCP on Vinkius and enter your BugHerd API Key. 2. Connect your preferred AI client (Claude, Cursor, etc.) to the MCP in your settings. 3. Use natural conversation with your agent. Ask it to list projects or update a task status, and it executes the action directly. ## Frequently Asked Questions **How can BugHerd MCP help me manage client bug feedback?** It lets you pull new reports from the dedicated queue using natural language. You don't have to jump into a separate client portal; your agent reads the latest submissions and helps you triage them right where you are working. **Can I update task statuses without logging in?** Yes, this MCP lets you communicate status changes directly. You just tell your agent which task needs updating and what its new status is (e.g., 'Doing' or 'Done'). It handles the API call for you. **What kind of projects can I list with BugHerd MCP?** You can list all your active development projects, getting names and essential metadata like unique IDs. This is useful for getting a high-level view of everything currently under development. **Is BugHerd MCP only for big teams?** No. It works for small teams too. You can use it to coordinate users and track specific tasks, making sure everyone knows who is responsible for what part of the project. **Does using BugHerd MCP save time on onboarding new people?** Yes. Instead of hunting through different documents, you can ask your agent to list all organization users immediately. It gives you a current directory and confirms roles for quick team coordination.