# Bugherd — MCP server on mcp.ai
> Connect your Bugherd account and use 26 tools for project management straight from your AI agent. Connect with your own API key. BugHerd is a visual feedback and bug tracking tool for websites, allowing clients and teams to report issues directly on live sites.

By: mcp.ai · official
Page: https://mcp.ai/bugherd

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_bugherd?ms=1787291520000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/bugherd/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/bugherd/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/bugherd/skill.md
Postman collection (v2.1): https://mcp.ai/bugherd/postman.json

## Tools
- bugherd_add_guest_to_project(email?: string, user_id?: integer, project_id: integer) — Tool to add a guest (client) to a project. Use when you want to add an existing client by ID or invite a new client by email.
- bugherd_add_member_to_project(user_id: integer, project_id: integer) — Tool to add a member to a project in BugHerd. Use when you need to add an existing user to a specific project.
- bugherd_create_attachment(url: string, task_id: integer, file_name: string, project_id: integer) — Tool to add a new attachment to a task using an existing URL. Use when you have project and task IDs and the external file URL ready.
- bugherd_create_column(name: string, position?: integer, project_id: integer) — Tool to create a new column in a project. Use when you need to add a custom workflow column after identifying the project ID.
- bugherd_create_comment(text: string, email?: string, task_id: integer, user_id?: integer, project_id: integer) — Tool to add a new comment to a task. Use when you need to record discussion or feedback on an existing task.
- bugherd_create_project(project: object) — Tool to create a new project. Use when you need to initialize a project after gathering its name and URL. Example: "Create a new project named 'My Website' with URL 'http://www.example.com'."
- bugherd_create_task(status?: string, priority?: string, tag_names?: string[], project_id: integer, description: string, external_id?: string, requester_id?: integer, assigned_to_id?: integer, requester_email?: string, assigned_to_email?: string) — Tool to add a new task in a project. Use when you have the project ID and full task details ready.
- bugherd_create_webhook(event: string, project_id?: integer, target_url: string) — Tool to create a new webhook for real-time event notifications. Use when you need to configure a callback endpoint for task or comment events. Example: "Create a webhook for 'task_create' events to be
- bugherd_delete_project(project_id: integer) — Tool to delete a project. Use when you need to permanently remove a project and its associated data. This action cannot be undone, so confirm the project ID before calling.
- bugherd_list_active_projects(page?: integer) — Tool to list all active projects in your BugHerd account. Use when you need to retrieve the active projects list (e.g., for syncing or reporting).
- bugherd_list_attachments(page?: integer, task_id: integer, project_id: integer) — Tool to list all attachments for a task. Use when you need to retrieve file attachments after fetching task details.
- bugherd_list_columns(project_id: integer) — Tool to list all columns for a project. Use when you need the full set of default and custom columns for a project.
- bugherd_list_project_tasks(tag?: string, page?: integer, status?: string, priority?: string, project_id: integer, external_id?: string, created_since?: string, updated_since?: string, assigned_to_id?: integer) — Tool to list tasks within a specific BugHerd project with optional server-side filters (status/column, assignee, tag, priority, date filters) and pagination. Use when you need to retrieve tasks scoped
- bugherd_list_projects(page?: integer) — Retrieves a paginated list of all projects in your BugHerd account. Returns project details including ID, name, creation date, owner, task status, and associated website URLs. Results are paginated wi
- bugherd_list_users(page?: integer) — Tool to list all users in your account. Use after authenticating to fetch the current user roster. Supports pagination via the `page` parameter.
- bugherd_list_webhooks() — Tool to list all installed webhooks. Use when you need to audit or verify existing webhooks after setup.
- bugherd_show_attachment(task_id: integer, project_id: integer, attachment_id: integer) — Tool to retrieve details of a specific attachment. Use after you have project_id, task_id, and attachment_id to get filename, URL, and timestamps.
- bugherd_show_column(column_id: integer, project_id: integer) — Tool to show details of a specific column. Use when you need metadata for a particular column within a project.
- bugherd_show_organization() — Tool to retrieve your BugHerd organization details. Use after authenticating to fetch account metadata.
- bugherd_show_project(project_id: integer) — Retrieves full details of a specific BugHerd project by ID. Returns comprehensive project information including name, settings, team members, guests, and kanban columns. Use this when you need detaile
- bugherd_show_user_projects(page?: integer, user_id: integer) — Tool to list all projects a specific user has access to. Use after obtaining the user's ID.
- bugherd_show_user_tasks(page?: integer, user_id: integer) — Retrieves all tasks created by or assigned to a specific user, grouped by project. Returns task details including ID, description, priority, status, timestamps, and tags. Requires a valid user_id (obt
- bugherd_update_column(column: object, column_id: integer, project_id: integer) — Tool to update a column in a project. Use when you have the project and column IDs and need to rename a column. Use after confirming the correct IDs.
- bugherd_update_project(project: object, project_id: integer) — Update settings for an existing BugHerd project. Use this to modify a project's name, URL, visibility settings, or guest permissions. Prerequisites: You need a valid project_id. Use list_projects to f
- bugherd_update_task(task: object, task_id: integer, project_id: integer) — Tool to update a task in a project. Use after confirming the project and task IDs.
- bugherd_upload_attachment(task_id: integer, file_name: string, project_id: integer, file_content: string) — Tool to upload a new attachment and add it to a specific task. Use when you have binary file content ready and need to attach it to a BugHerd task.

## Example prompts
- "What can I do in Bugherd?"
- "Show me a summary of my Bugherd account"

## Links
Docs: https://mcp.ai/docs/mcps/bugherd
Website: https://mcp.ai/mcps/bugherd