{
  "info": {
    "name": "Bugherd — mcp.ai",
    "description": "REST API for the Bugherd MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/bugherd",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "bugherd_add_guest_to_project",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/guest/to/project",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "guest",
            "to",
            "project"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"email\": \"\",\n  \"user_id\": 0,\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_add_member_to_project",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/member/to/project",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "member",
            "to",
            "project"
          ]
        },
        "description": "Tool to add a member to a project in BugHerd. Use when you need to add an existing user to a specific project.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"user_id\": 0,\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_create_attachment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/attachment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "attachment"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\",\n  \"task_id\": 0,\n  \"file_name\": \"\",\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_create_column",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/column",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "column"
          ]
        },
        "description": "Tool to create a new column in a project. Use when you need to add a custom workflow column after identifying the project ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"position\": 0,\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_create_comment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/comment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "comment"
          ]
        },
        "description": "Tool to add a new comment to a task. Use when you need to record discussion or feedback on an existing task.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"text\": \"\",\n  \"email\": \"\",\n  \"task_id\": 0,\n  \"user_id\": 0,\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_create_project",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/project",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "project"
          ]
        },
        "description": "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'.\"",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"project\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_create_task",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/task",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "task"
          ]
        },
        "description": "Tool to add a new task in a project. Use when you have the project ID and full task details ready.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"status\": \"\",\n  \"priority\": \"\",\n  \"tag_names\": \"\",\n  \"project_id\": 0,\n  \"description\": \"\",\n  \"external_id\": \"\",\n  \"requester_id\": 0,\n  \"assigned_to_id\": 0,\n  \"requester_email\": \"\",\n  \"assigned_to_email\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_create_webhook",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/webhook",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "webhook"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"event\": \"\",\n  \"project_id\": 0,\n  \"target_url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_delete_project",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/project",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "project"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_list_active_projects",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/active/projects",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "active",
            "projects"
          ]
        },
        "description": "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).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_list_attachments",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/attachments",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "attachments"
          ]
        },
        "description": "Tool to list all attachments for a task. Use when you need to retrieve file attachments after fetching task details.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"task_id\": 0,\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_list_columns",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/columns",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "columns"
          ]
        },
        "description": "Tool to list all columns for a project. Use when you need the full set of default and custom columns for a project.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_list_project_tasks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/project/tasks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "project",
            "tasks"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tag\": \"\",\n  \"page\": 0,\n  \"status\": \"\",\n  \"priority\": \"\",\n  \"project_id\": 0,\n  \"external_id\": \"\",\n  \"created_since\": \"\",\n  \"updated_since\": \"\",\n  \"assigned_to_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_list_projects",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/projects",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "projects"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_list_users",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "users"
          ]
        },
        "description": "Tool to list all users in your account. Use after authenticating to fetch the current user roster. Supports pagination via the `page` parameter.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_list_webhooks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/webhooks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "webhooks"
          ]
        },
        "description": "Tool to list all installed webhooks. Use when you need to audit or verify existing webhooks after setup.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_show_attachment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/show/attachment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "show",
            "attachment"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"task_id\": 0,\n  \"project_id\": 0,\n  \"attachment_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_show_column",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/show/column",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "show",
            "column"
          ]
        },
        "description": "Tool to show details of a specific column. Use when you need metadata for a particular column within a project.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"column_id\": 0,\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_show_organization",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/show/organization",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "show",
            "organization"
          ]
        },
        "description": "Tool to retrieve your BugHerd organization details. Use after authenticating to fetch account metadata.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_show_project",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/show/project",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "show",
            "project"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_show_user_projects",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/show/user/projects",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "show",
            "user",
            "projects"
          ]
        },
        "description": "Tool to list all projects a specific user has access to. Use after obtaining the user's ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"user_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_show_user_tasks",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/show/user/tasks",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "show",
            "user",
            "tasks"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"user_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_update_column",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/column",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "column"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"column\": {},\n  \"column_id\": 0,\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_update_project",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/project",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "project"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"project\": {},\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_update_task",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/task",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "task"
          ]
        },
        "description": "Tool to update a task in a project. Use after confirming the project and task IDs.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"task\": {},\n  \"task_id\": 0,\n  \"project_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "bugherd_upload_attachment",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/upload/attachment",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "upload",
            "attachment"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"task_id\": 0,\n  \"file_name\": \"\",\n  \"project_id\": 0,\n  \"file_content\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}